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머리말 

위대한 령도자 김정 일 동지께서는 다음과 같이 지적하시였다. 

<정보산업을 빨리 발전시키고 인민경제의 모든 부문을 정보화하여야 합니다.》 

(《김정일 선집》제15권， II 4 폐지) 

위대한 령도자 김정일 동지의 현명한 령도에 의하여 오늘 우리 나라에서는 인민경제의 
정보화를 실현하기 위한 투쟁이 힘있게 벌어지고있다. 

인민경제의 정보화를 실현하고 정보산업을 하루빨리 세계적수준에 끌어올리기 위해서는 정 
보기술 특히 프로그람기술을 빨리 발전시키고 능률적 인 프로그람들을 적극 개발하여야 한다. 

이 책에서는 《붉은별》과 Linux 조작체계에서 실행할수 있는 프로그람들을 개발하기 위 
한 개 발도구인 (가와 KDE 에 기 초한 GUI 프로그람작성 법 에 대하여 설명한다. 

1장에서는 Qt 와 KDE 서고를 가지고 대체로 수행하는 일과 각종 클라스들을 사용하여 
실행프로그람을 구축하는 방법에 대한 기초지식을 학습한다. 

2장에서는 Qt 와 KDE 응용프로그람들에서 기본창문을 만들고 현시하는데 사용하는 클라 
스들을 설 명한다. 

3장에 서 는 창문과 대 화칸들의 내 용을 조직 하는 방법 을 설 명한다. 

4장과 5장에 서 는 튀 여나오기 대 화칸，사용자정 의 대 화칸，그리 고 Qt 5 f KDE 의 부분으로 
정의된 대화칸들에 대하여 학습한다. 

6장에서는 차림표와 도구띠의 구축과 관리방법을 설명한다. 

7장에서는 on 과 off 상태를 절환하는 단추집합과 같이 그룹에 포함되는 창문부품들의 관 
리방법 을 설 명한다. 

8장에 서 는 프로그람이 마우스와 단추에 응답하는 방법 을 설 명한다. 

9장에서는 파일로부터 적재되거나 프로그람으로 를파일된 화소준위도형을 관리하고 현 
시하는 방법을 설명한다. 

10장에 서 는 서 체 와 문자렬 현시 과정 을 설 명 한다. 

11장에서는 색을 만들고 관리하는데 사용하는 옵션들을 설명한다. 

12장에서는 QPainter 클라스를 리용하여 넓은 범위의 자세한 도형그리기를 수행하는 실 
례들을 설명한다. 

13장에서는 특정크기에 맞게 도형을 조작하거나 임의의 폐지에 배치하는 과정 그리고 
동화상에 대 하여 설 명한다. 

14장에서 는 도형 또는 본문객 체 를 끌어 다놓는 실 례 들을 설명한다. 

15장에서는 응용프로그람들사이의 자료를 통신하는 과정을 설명한다. 

16장에서 는 기 타 편의 클라스들의 실례를 설명한다. 

17장에 서 는 국제 화를 위한 KDE 편의 클라스들을 설 명한다. 

18장에 서 는 Qt 창문부품들을 자모순으로 설 명한다. 

19장에서는 KDE 창문부품들을 실례를 들어 설명한다. 

20장에 서 는 Win 32, KDE , GNOME 으로 작성 한 같은 프로그람들의 실 례 를 설 명 한다. 
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제 1 장. KDE 의 기초 


학습내용 

KDE 의 전 체 구조와 매 개 구성 요소들을 리해 
(건가 프로그람개발에서 차지하는 역할 
KDE 가 프로그람개발에서 차지하는 역할 
창문부품과 사건모형 


쏘프트웨어의 이름은 K Desktop Environment 간단히 KDE 라고 부론다. 이 장은 KDE 의 응 
용프로그람개발환경 에 대한 소개 이 다. KDE 는 Linux 와 UNIX 계렬조작체계 에서 인기 있는 도형방 
식사용자대면부이 다. 사실상 UNIX 계렬의 모든 도형 방식대면부들은 X 창문체계상에 구축된다. 
X 창문체계는 많은 체계들에서 이식가능한 도형방식을 주며 도형객체들의 Qt 서고는 응용프로 
그람의 기본구축블로크를 제공하며 KDE 서고는 표준형식을 제공한다. 

제1절. KDE 음용프로그람의 구조 

KDE 응용프로그람은 다른 많은 코드에 기초하여 작성한다. 

응용프로그람을 작성 하는 구체 적 인 일은 대 부분 이 미 수행되 여있으며 그것 은 수행 하려 
는 응용프로그람에 련결되는 코드서고에 상주한다. 

그림 1-1 은 KDE 응용프로그람을 만드는 쏘프트웨어준위들에 대한 개념을 준다. 


몽용프로그람 
KDE 클라스 
Qt 클라스 
C++API 

glib XII 
조작제계 

그림 1-1. Linux 에서 KDE 응용프로그람에 대 한 쏘프트웨 어 준위 들 

그림에서는 준위들이 완전히 독립되여있지만 실제로 그렇지 않다. 례를 들면 실제의 호 
출은 KDE 클라스로부터 glib 함수들에로 이루어지며 응용프로그람은 직접호출 즉 glib 나 체계 
호출을 방해하지 않는다. 응용프로그람은 일반적으로 KDE 와 Qt 로부터 클라스들을 사용한다. 
그러나 호출은 오직 아래로 향한다. 실례로 Qt API 의 부분은 KDE 에서 어떤것도 사용하지 
않는다. 





이 책은 2준위와 3준위 ( KDE 와 Qt ) 의 기능을 리용하여 제일 웃준위에서 동작하는응용프 
로그람을 만드는 방법을 주며 다른 준위의 사용법에 대하여서는 거의 설명하지 않는다. 실 
제로 그것은 KDE 와 어의 중요한 목적중의 하나로서 프로그람작성자를 낮은 준위의 구체적 
인 조종으로부터 격 리시킴으로써 응용프로그람개 발과정 을 간단화한다. 


제2절. 쏘프트웨어준위 

이 절에서는 그림 i - i 에서 보여주는 쏘프트웨어준위들을 설명한다. 

1. 체계 

체 계 준위 는 모든 Linux 응용프로그람에서 사용할수 있는 쏘프트웨어 의 제 일 아래 층이다. 
일부 아래준위의 체계호출은 조작체계와 그 구동프로그람들에로의 직접호출을 제공하여 파 
일열기와 등록부창조와 갈은 일을 수행한다. Linux 핵심은 C 로 씌여지므로 이 것들은 모두 C 
함수호출이 다. 

2. glib 

glib 는 우의 모든 층들에 서 사용되 는 C 함수，마크로 그리 고 구조체 들의 모임이 며 응용 
프로그람에서도 사용한다. glib 서고는 기억할당，문자렬형식화, 날자와 시간，입출력，그리고 
시계용 함수를 포함한다. 또한 련결목록，배렬, 하쉬표，나무, 쿼크 및 캐쉬용 편의함수들을 
가지고있다. glib 에 의해 조종되는 중요한 함수들중 하나는 기본순환고리로서 KDE 가 응용프 
로그람의 코드들을 동시에 실행하는 여러 자원을 조종하게 한다. 

3. XII 

이것은 현시를 조종하는데 사용되는 저준위함수들을 포함하는 도형처리층이다. 모든 기 
본창문함수들이 포함되며 이 함수들은 창문을 현시하고 마우스와 건반사건에 응답한다. 이 
서고는 여러해동안에 매우 안정되였으며 판번호는 그리 변화하지 않았다. 현재 그 판번호는 
11( 이름이 가리키는것처 럼)이다. 그리고 판 11이 출하물 6에 있으므로 X 11 R 6 으로서 알려져 
있다. 그 원시이름에는 판번호가 없었으므로 흔히 간단히 표라고 불리운다. 

4. C ++ API 

이 층은 모두 C ++ 로 씌여졌으므로 C ++ 실행시체계는 새 객체창조와 I/O 흐름조종과 
갈은 것을 위해 호출된다. 

5 . Qt 클라스 

이 층의 C ++ 모임은 응용프로그람을 만드는데 사용되는 여러가지 창문부품들(단추，창 
틀 등)을 실현하며 창문들과 결합하여 복잡한 도형방식대화칸들을 만드는 능력을 가지고있 
다. 창문부품들을 현시하는것과 함께 입력시에 마우스와 건반사건에 응답할수 있고 입력창 
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문으로부터 필요한 프로그람부분에로 정보를 발송한다. 


6. KDE 클라스 

이 클라스들은 Qt 클라스들을 수정하고 기능을 추가한다. 많은 KDE 클라스가 있으나 그 
대부분은 하나이상의 Qt 클라스들로부터 직접 확장된다. 이 층은 KDE 에 그 유일한 외관을 
주고 창문, 마우스 그리고 건반 모두가 서로 교제하는 방법을 표준화한다. 

7. 응용프로그람 

응용프로그람의 2가지 기 본특성 은 Qt 응용프로그람 그리 고 KDE 응용프로그람을 창조할 
수 있는것이다. Qt 응용프로그람은 QApplication 객체를 만들고 초기화하며 KDE 응용프로그람은 
KApplication 객체를 만들고 초기 화한다. KApplication 클라스는 KDE 응용프로그람의 표준외 관과 
필요한 기능들을 추가함으로써 QApplication 클라스를 확장한다. 

제3절. 어에 대하여 

Qt 는 C ++ GUI 응용프로그람개 발쏘프트웨어 의 서 고이다. Qt 의 목적 은 응용프로그람의 사 
용자대면부를 개발하는데 필요한 모든 기능을 제공하는것으로서 주로 C ++ 클라스모임의 형 
식으로 실현된다. 

노르웨이의 TrollTech 회사 ( ht 1 p :// www . 仕 olltech . com ) 는 1995년에 처음으로 상업용 (가를 소 
개 하였다. 

Qt 클라스모임은 매우 든든하며 Qt 를 사용하여 완전한 응용프로그람을 작성할수 있다. 
사실상 응용프로그람의 기본형식을 보여주기 위하여 이 책에서 처음의 몇가지 실례는 오직 
Qt 만 사용한다. Qt 클라스는 기본창문조종, 끌어다놓기 그리고 망프로그람작성을 위한 국제화 
에 이르기까지의 모든 기능을 포함한다. 

이 전에 쏘프트웨어사용허 가제 한들로 인하여 공개원천개 발분야에서 는 (경의 사용에서 일 
정한 제 한이 있 었다. 그러 나 사용허 가는 더 이상 필요없게 되 였다. 최 근에 Trolltech 는 완전히 
자유로운 (가판을 배 포하였으며 그것 은 GPL(GNU General Public License ) 하에 서 허 가된다. 또한 
같은 쏘프트웨어를 QPL(Q Public License ) 하에서도 사용할수 있다. 이 러한 2중사용허가는 공 
개 원천쏘프트웨어 와 소유권있는 쏘프트웨 어 개 발을 모두 허 용한다. 

Qt 2.2.1 배 포물에 는 쏘프트웨어 의 3개 의 판이 있 다. 

- Qt Free Edition 은 GPL 하에서 허가되고 내리적재할수 있고 어떠한 공개원천프로젝트에 
도 자유롭게 사용할수 있다. 

- Qt Professional Edition 은 상업적이고 소유권있는 쏘프트웨어개발에서 사용된다. 사용허 
가와 쏘프트웨어 를 구입 하여 야 한다. 

•Qt Enterprise Edition 은 Qt Professional Edition 과 같이 허 가되 지 만 추가적 인 쏘프트웨 어 모 
듈을 포함한다. 이 확장은 OpenGL ， 망기술， XML , 표계산 그리고 특별히 최적화된 2 D 도형 처 
리묶음을 포함한다. 
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1. QObject 클라스 

대부분의 QObject 클라스들은 기초클라스 QObject 를 계승한다. 이것은 사실상 Qt 서고의 
모든 클라스들이 꼭갈은 메 쏘드들의 기 본모임 을 포함한다는것 을 의 미한다. QObject 클라스의 
구성자는 마음대로 부모객체의 주소와 이름을 객체에 할당하는 문자렬을 받아들일수 있다. 
QObject (QObject *parent = 0， const char *name = 0); 

다음 메 쏘드들은 QObject 에 선 언 되 여있 다. 

void blockSignals(bool b); 

QObject *child(const char *name, const char *type = 0); 
const QObjectList *children() const; 
virtual const char *className() const; 

static bool connect(const QObject * sender, const char * signal, const QObject *receiver, const char *member); 

bool connect(const QObject * sender, const char * signal, const char *member) const; 

static bool disconnect(const QObject * sender, 

const char * signal, const QObject *receiver, const char *member); 

bool disconnect(const char * signal = 0, const QObject *receiver = 0, const char *member = 0); 

bool disconnect(const QObject *receiver, const char *member = 0); 

void dumpObj ectInfo(); 

void dumpObjectTreeO ； 

virtual bool event(QEvent *); 

virtual bool eventFilter(QObject *, QEvent *); 

bool highPriorityO const; 

bool inherits(const char *) const; 

virtual void insertChild(QObject *); 

void installEventFilter(const QObject *); 

bool isA(const char *) const; 

bool isWidgetType() const; 

void killTimer(int id); 

void killTimers(); 

virtual QMetaObject *metaObject() const; 
const char *name() const; 

const char *name(const char *defaultName) const; 
static const QObjectList *objectTrees(); 

QObject *parent() const; 

QVariant property(const char *name) const; 

QObjectList *queryList(const char *inheritsClass = 0, const char *objName = 0, bool regexpMatch = TRUE, 
bool recursiveSearch = TRUE); 
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virtual void removeChild(QObject *); 

void removeEventF ilter(const QObject *); 

virtual void setName(const char *name); 

bool setProperty(const char *name, const QVariant &value); 

bool signalsBlocked() const; 

int startTimer(int interval); 

QStringList superClasses(bool includeThis = FALSE) const; 
static QString tr(const char *); 

이 메쏘드의 대부분은 이 책의 여러 실례들에서 사용된다. 일부 Qt 객체들은 프로그람안 
의 다른 객체가 받아들일수 있는 신호를 발생시킬수 있는 능력을 가지고있다. QObject 객체는 
해체자가 호출될 때마다 다음 신호를 발생시킨다. 
void destroyed(); 

신호와 그것을 받아들이는 처리부는 주로 다음 장에서 설명하며 이 책에는 많은 실례 
들이 포함되여있다. 

2. MOC 콤파일러 

개발자가 사용하는 한가지 프로그람은 메타객체콤파일러(또한 MOC 를파일러)이다. 

MOC 콤파일러는 원천코드를 읽어들여 응용프로그람을 콤파일，련결하는데 필요한 특별 
한 C ++ 원천파일들을 생성한다. 이 특수파일들은 다른 객체들의 하나이상의《처리부》들이 받 
아들이 는《신호》를 발생시키 는데 필요한 코드를 포함한다. 신호는 응용프로그람안의 한 객 
체 에서 다른 객 체 에로 정 보를 비 동기적 으로 전송하는데 사용되 는 메쏘드이 다. 

MOC 콤파일러는 클라스선언에 Q_OBJECT 마크로가 존재하는가에 따라서 코드를 생성하 
겠는가 생성하지 않겠는가, 어떤 코드를 생성하겠는가를 결정한다. 결과의 원천코드는 따로 
따로 콤파일되 고 련결되 거 나 또는 간단히 #include 지 령 에 의해 코드에 포함된다. 

MOC 를파일러의 리용은 신호와 처리부들을 동작시킬뿐아니라 모든 Qt 클라스에서 (그리 
고 계승에 의해 프로그람의 모든 객체에서) 선언된 특별한 메쏘드들을 리용할수 있는 코드 
를 생 성한다. 표 1-1 에 보여 주는 이 메 쏘드들은 QObject 클라스에서 선 언된다. 


표 1-1. 

QObject 의 MOC 메쏘드들 

메쏘드 

설명 

className () 

클라스이름을 문자렬로 돌려준다. 이것은 RTTI ( 실행시형식별)기능을 

요구하지 않는다. 

inherits () 

이 클라스가 다른 클라스를 계승하는가 아닌가를 지정하는 론리값을 

돌려 준다. 

tr () 

국제화를 위한 문자렬번역을 수행한다. 

setProperty () 

이 름에 의해 객 체 속성 을 설 정한다. 

property () 

이름있는 객체속성을 돌려준다. 
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메쏘드 

설명 

metaObject () 

클라스의 QMetaObject 객체를 돌려준다. 메타객체는 클라스에 대한 자 

세한 설명정보를 포함한다. 


제 4 절. KDE 에 대하여 

KDE 는 도형방식탁상환경의 공개원천개발계획이다. 준말의 첫 문자 K 는 의미를 가지지 
않고 단지 이름이다. 

KDE 쏘프트웨어는 (겨를 사용하여 구축한다. 계획 은 (건의 첫판본이 공개된 1996년에 시 
작되 였 으며 그후 점 차 응용프로그람의 큰 집합을 가진 매 우 완전 한 탁상환경 으로 되 였 다. 

쏘프트웨 어개발자의 견지 에서 KDE 는 매우 간단하다. KDE 계획의 일부로서 씌여진 쏘프 
트웨어 의 대 부분이 탁상환경 의 완전한 부분으로 사용되 고있으며 많은 클라스들이 개 발되 여 
핵심 KDE API 의 부분으로 포함되였다. 이 클라스들은 KDE 응용프로그람에 표준형식을 제공 
한다. 클라스들의 대부분은 Qt 서고의 하나이상의 클라스들을 계승하며 KDE 클라스중 일부는 
Qt 의 클라스들에 기능을 추가하지만 그 대부분은 간단히 KDE 의 표준외관을 유지관리하기 
위한것 이 다. 오직 여의 클라스들만 리용하여 모든 응용프로그람을 작성 하는것 은 대 단히 쉽 
지만 KDE 클라스들을 리용하면 응용프로그람은 탁상에 의거하여 통합된것처럼 보인다. 

제5절. 사건의 발생 

K Des 吐 op Environment 에 서 실 행 하는 응용프로그람은 사건 구동형 프로그람이 다. 사건구동 
이라는것은 프로그람이 실행을 시작할 때 창문(또는 창문들)을 현시하고 마우스나 건반으로 
부터 입력을 기다린다는것을 의미한다. 입력은 사건이라고 하는 객체에 보관된다. 또한 사건 
은 프로그람에게 창문이 닫기였거나 창문이 다른 창문뒤에 가리워졌다가 로출되였다는것을 
알릴수 있다. 응용프로그람의 목적 은 건 반과 마우스사건 에 지 능적 으로 응답하는것 이 다. 

응용프로그람은 1개의 기본적 인 제 일웃준위창문을 가지고있다. 또한 다른 창문들을 가 
질수 있다. 창문은 응용프로그람의 생명주기 전기간 존재하거나 응용프로그람이 사건에 응 
답할 때 나타나거나 사라질수 있다. 

매 개 창문은 창문부품에 은폐 된 다. 응용프로그람의 제 일 웃준위창문은 창문부품이 다. 매 
개 튀여나오기창문도 역시 창문부품이다. 사실상 현시기는 창문부품들로 구성된다. 하나의 
창문부품은 다른 창문부품들을 포함하고 현시할 능력 이 있으며 모든 단추, 표식 자 그리 고 
차림 표항목은 개 별적 인 창문부품이 다. 응용프로그람의 도형방식대 면부의 프로그람작성 은 창 
문부품들을 만들고 결합한 다음에 창문부품들을 능동으로 하고 창문부품들이 받아들인 사건 
들에 응답하는 코드를 쓰는 문제 이다. 

창문부품은 QWidget 라는 Qt 클라스로부터 계 승되 는 클라스들이 다. QWidget 객 체 는 자체 의 
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현시가능창문을 포함하고 관리한다. 또한 마우스와 건반에 의해 발생하여 창문부품내의 창 
문에 보내오는 사건들에 응답하도록 설정될수 있다. 사건들은 현재의 보임상태, 크기, 배경 
색，전경색, 현재위 치 등을 포함하며 Qt 또는 KDE 에서 선 언된 창문부품들을 사용하거 나 
QWidget 를 기초클라스로 사용하여 창조할수 있다. 

제6절. 객체의 이름 

Qt 클라스이름은 문자 Q 로 시작되고 KDE 클라스이름은 문자 K 로 시작된다. 그러므로 프 
로그람의 원천코드를 읽을 때 클라스가 선언되는 서고를 결정할수 있다. 첫 문자외에 갈은 
이름을 가지는 2개 클라스가 있으면 그것은 한 클라스가 다른 클라스의 확장이라는것을 의 
미한다. 실례로 KDE 클라스 KPixmap 은 그 기초클라스로서 Qt 클라스 QPixmap 를 사용한다. 

Qt 와 KDE 에서 모든 클라스들은 머리부파일에서 선언된다. 거의 모든 경우에 머리부파 
일의 이름은 클라스의 이름으로부터 알수 있다. 실례로 QPopupMenu 클라스의 머리부파일은 
qpopupmenu . h 이고 클라스 KfontDialog 는 kfontdialog . h 에서 선언된다. 그러나 둘이상의 클라스 
가 하나의 머리부파일에서 선언될수 있으므로 명명관례는 일반적으로 옳지 않다. 실례로 클 
라스 KFontChooser 는 kfontdialog . h 에서 선언된다. 또한 일부 원천파일이름은 간략된다. 실례 
로 KColorDialog 의 머 리 부는 kcolordlg.h 이 다. 

요 약 

이 장은 KDE 의 프로그람작성환경 에 대하여 아주 간단히 그리고 일반적으로 소개하였 
다. 이 장에서 소개한 개념들은 다음과 같다. 

• 일부 쏘프트웨 어 층은 KDE 쏘프트웨어 서 고를 유지한다. 

• X 창문체계는 아래준위 GUI 대면부를 조종한다. KDE 서 고는 그 바로 아래 에 있으며 Qt 쏘 
프트웨어 에 중요하게 의 존하는 쏘프트웨 어 층이 다. 

• 모든 응용프로그람은 사건구동형 이 다. 응용프로그람은 적 어도 하나의 창문을 현시한 
다음 마우스 또는 건반으로부터 입력을 기다린다. 

(자기가 Windows 프로그람작성자이지만 KDE 에 익숙되지 못했다면 KDE 프로그람과 
Windows 프로그람을 비 교하는 20장을 읽 으시 오. 그렇 지 않으면 2장으로 넘 어 가서 아주 간단 
한 KDE 응용프로그람의 실례로부터 학습을 시작하시오.；) 
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제 2 장. 창문의 창조와 현시 


학습내용 

몇행의 코드로 간단한 프로그람의 작성 

KDE 프로그람의 실현이 간단히 추가된 능력을 갖춘 Qt 프로그람의 실현 

C ++ 객체를 코드화하여 창문을 창조하기 

신호를 받아들일 처리부를 지정하여 입력에 응답하는 방법 

쏘프트웨어 의 이 름은 K Desktop Environment 간단히 KDE 라고 부론다. 이 장은 KDE 이 
장은 Qt 또는 KDE 응용프로그람의 기 본형 식 을 설 명한다. 

이 장의 실례들은 원천의 기본형식과 그 원천을 실행가능프로그람으로 바꾸는데 필요 
한 과정을 설명하도록 설계되였다. 프로그람의 여러 부분사이의 관계를 될수록 쉽게 리해하 
도록 하기 위 하여 실 례 들은 모두 간단히 손으로 작성한 makefile 들을 사용한다. 처 음의 실 례 
는 간단한 Qt 응용프로그람이 고 두번째는 KDE 응용프로그람이다. 다른 실례들은 어떻 게 누름 
단추사건에 응답하고 다른 창문부품들을 포함하는 현시창문부품을 만드는가를 보여준다. 

제1절. Hello Qt 

다음 실례프로그람은 간단한 창문을 만들어 표시한다. 그것은 본문행을 현시하는것외에 다른 
것은 없지만 Qt 프로그람의 기본형식을 보여준다. 실행결과는 그림 2-1 에 보여준다. 

1 /* helloworld.cpp */ 

2 #include <qapplication.h> 

3 #include <qlabel.h> 

4 #include <qstring.h> 


6 int main(int argc, char **argv) 

7 { 

8 QApplication app(argc, argv); 

9 QLabel *label = new QLabel(NULL); 

10 QString string (” Hello, world”); 

11 label->setT ext(string); 

12 label->setAlignment( 

13 Qt::AlignVCenter | Qt::AlignHCenter); 

14 label->setGeometry(0,0,180,75); 

15 label-〉show(); 

16 app. setMainWidget(label); 

17 retum(app.exec()); 
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Hello 


Hello, world 


그림 2-1. 본문을 현시하는 간단한 Qt 프로그람 

2행에서 포함한 파일 qapplication . h 는 main () 함수가 들어있는 원천파일을 가지고있다. 이 
실례는 본문을 현시하는데 QLabel 창문부품을 사용하므로 qlabel . h 를 포함하여야 한다. 그리고 
QLabel 객체에 현시되는 본문을 지정하는데 QStting 객체를 요구하므로 qstring 上를 4행에서 포 
함한다. 

8행 은 app 라고 부르는 QApplication 객체 를 만든다. QApplication 객 체는 응용프로그람의 제 
일 웃준위창문(또는 창문의 모임 )을 보유하는 용기 이 다. 응용프로그람의 제 일 웃준위창문은 절 
대로 부모창문을 가지지 않는다. QApplication 객체가 객체들을 넘겨받고 응용프로그람을 관러 
하므로 이 객체는 프로그람마다 오직 하나만 있을수 있다. 또한 QApplication 객체의 창조는 
Qt 체계를 초기화하므로 다른 아기능들을 사용하기전에 존재하여야 한다. 

Qt 프로그람은 C ++ 프로그람이다. 이것은 프로그람을 기동할 때 main () 이라는 함수가 조 
작체계 에 의 해 호출된다는것을 의 미 한다. 그리 고 모든 C ++ 프로그람들처 럼 지 령행선택들을 
mainO 에 넘길수도 있고 넘기지 않을수도 있다. 지 령행선택은 8행 에서처 럼 초기화과정의 부 
분으로서 Qt 쏘프트웨어 에 넘어 간다. 

2개의 지령 행인수 argc 와 argv 는 특별 한 기발과 환경설정을 지정 할수 있 으므로 app 의 
구축에 사용된다. 실례로 Qt 프로그람을 - geometey 로 기동하여 그것이 현시되는 창문의 크기 
와 위치를 지 정한다. 사용자는 프로그람을 기동하는 속성 ( profile ) 정보를 바끔으로써 프로그람 
의 모양을 개성화할수 있다. 

QLabel 창문부품은 9행 에서 만들어 진다. QLabel 창문부품은 간단히 문자렬을 현시할수 있 
는 창문이 다. 표식 자는 제 일웃준위창문이 고 제 일웃준위창문은 부모가 없으므로 그 부모창문 
부품이 NULL 로서 만들어진다. 표식자는 창조될 때 본문을 가지지 않고 10행에서 만들어진 
QString 객체를 넘겨받는다. 

QString 객체는 11행에서 setText () 호출에 따라 QLabel 에 설정된다. QLabel 의 기정동작은 
문자렬을 수직으로 중심에, 왼쪽으로 맞추어 현시하는것이므로 12행에서 setAlignmentO 를 호 
출하여 본문을 수직 뿐아니 라 수평 으로도 중심 에 배 치한다. 

14행에서 setGeometry () 호출은 QApplication 창문안에 있는 표식자창문부품의 위치, 높이 
그리고 너비를 결정한다. 이 실례 에서 표식자는 기본창문의 왼쪽웃구석 (0,0) 에 놓인다. 또한 
180화소너비와 75화소높이로 지정된다. 기본창문은 현시하기전에 표식자의 크기를 알아야 
표식 자를 포함하기 위한 창문의 크기 를 설 정할수 있 다. 

16행 의 show () 호출은 표식 자를 창문에 실제 로 표시한다. show () 함수는 즉시 창문부품을 
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현시하지 않고 시간이 되였을 때에만 현시하도록 환경을 구성한다. 부모창문(이 경우에 

QApplication 창문)은 표식자를 현시하는 일은 표식자의 show () 호출이 있어야만 가능하다. 
hideG 라는 다른 함수는 현시된 창문부품이 은폐되게 한다. 

11행의 setMainWidget () 호출은 기본창문에 표식자를 삽입한다. 이 실례에서는 QLabel 객 
체가 사용되지만 보통 창문부품은 창문부품, 본문 그밖에 응용프로그람의 기본창문의 각이 
한 요소들의 모임 을 포함하는 합성창문부품이 다. 끝으로 17행 에서 exec (} 호출이 이 루어 진다. 
이 함수는 프로그람이 실행을 멈출 때까지 귀환하지 않는다. execO 는 그 완성상태를 표시하 

는 int 값을 돌려주며 우리가 그 상태코드를 처리하지 않으므로 값은 단순히 체계에로 되돌아 

간다. 

프로그람이 간단하고 오직 하나의 원천파일로 이루어져 있으므로 그것을 콤파일하는 

makefile 도 아주 간단하다. 

INCL= -I$(QTDIR)/include -I$(KDEDIR)/include 

CFLAGS= -pipe -02 -fiio-strength-reduce 

LFLAGS= -L$(QTDIR)/lib -LS(KDEDIR)/lib -L/usr/XllR6/lib 

LIBS= -lqt -1X11 -lXext 

CC=g++ 

helioworld: helloworld.o 

$(CC) $(LFLAGS) -o helloworld helloworld.o $(LIBS) 
helloworld.o: helloworld.cpp 

rm -f helloworld 
rm -f helloworld.o 
.SUFFIXES: .cpp 
.cpp.o: 

$(CC) -c $(CFLAGS) $(INCL) -o $@ $< 

makefile 은 환경변 수 QTE « R 와 KDEI 기 R 가 Qt 와 KDE 개 발체 계 의 설 치 등록부이 름으로 정 
의되는것으로 가정한다. 보통 이 2개의 환경변수는 쏘프트웨어를 설치할 때 설정된다. 표 
2-1 과 같이 makefile 에서 5개의 이름이 정의된다. 

표 2-1. Makefile 에서 정의된 변수들 


이름 

내용 

INCL 

머리부파일들이 있는 위치의 경로이름. 이것은 머리부파일들을 찾는 위치를 

콤파일러에 넘긴다. 항상 콤파일러는 표준머리부를 / usr / include 에서 조사한 

다. 

CFLAGS 

콤파일러 에 넘긴 옵션목록. - pipeoption 은 2단계의 콤파일사이에 자료를 넘길 
때 일시 파일대신에 파이 프들을 사용할것을 콤파일러 에 지 시한다. -02 옵션은 
아주 높은 준위 의 최 적 화를 지 정 한다. fno - strength - reduce 옵션 은 최 적 화가 순 

환변수들을 줄이거나 제거하는것을 막는다. 

LFLAGS 

련결프로그람에 넘기는 옵션목록. 매개 - Loption 은 둘이상의 서고를 포함하 
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이름 

내용 


고있는 등록부를 지정한다. 

LIBS 

이 프로그람에 요구되는 서고이름들의 목록. 이름있는 서고는 LFLAGS 에 의 

해서 지정된 등록부들에서 람색된다. 매개의 이름은 서고파일의 이름으로 
확장된다. 실례로 -lqt 는 libqt.so 로 바뀌고 -1 X 11 은 libXll.so 로 된다. 

CC 

를파일러의 이름. 


makefile 의 마지막 두 행은 .cpp 파일을 .ofile 로 바꾸는 지령을 구성하는 방법을 make 에 
알리는데 사용된다. 이 실례에는 원천파일이 하나만 있지만 여러개이면 변환규칙을 사용하 
여 콤파일지령을 한번 정의하여 전체 makefile 에 적용하도록 한다. 

알아두기: makefile 을 쓰는 방법은 무한히 많다. 이 실례는 상대적으로 간단하므로 리 
해 하기 쉽 다. 응용프로그람을 개 발할 때 makefiles 에 다른것 들도 추가해 야 한다. 


제2절. Hello KDE 

그림 2-2 에 보여주는것처럼 이 실례는 ^Application 객체가 아니라 KApplication 객체에 기 
초하고있는것을 제외하면 앞의 실례와 같다. KApplication 클라스는 (^Application 에 기초하므로 
형식 과 주제, KDE 창문부품들의 사용능력，표준 KDE 환경 구성 에 대한 호출, 쎄손관리정 보호출 
그리 고 사용자의 웨브열람기 와 전자우편의 뢰 기 호출과 같은 KDE 기 능들의 추가외 에 근본적 인 
차이는 없다. 

1 /* hellokde.cpp */ 

2 #include <kapplication.h> 

3 #include <qlabel.h> 

4 #include <qstring.h> 

5 

6 int main(int argc, char **argv) 

7 { 

8 KApplication app(argc, argv, "hellokde"); 

9 QLabel *label = new QLabel(NULL); 

10 QString string (” Hello, KDE’，); 

11 label->setT ext(string); 

12 label->setAlignment( 

13 Qt::AlignVCenter | Qt: : AlignHCenter); 

14 label-〉setGeometry(0,0,180,75); 

15 label-〉show(); 

16 app. setMainWidget(label); 

17 retum(app. exec()); 







그림 2-2. 본문을 현시하는 간단한 KDE 프로그람 
KApplication 객체는 2행에서 포함한 머리부과일 kapplication.h 에서 선언된다. kapplication.h 
과일은 qapplication.h 파일을 포함하므로 Qt 프로그람에 사용할수 있는 모든 기능은 KDE 프로 
그람에도 사용할수 있다. 3행과 4행에 포함한 머리부파일들은 QLabel 과 QString 클라스의 선 
언을 보관한다. 

8행에서 지령행 인수와 응용프로그람이름을 넘기 여 KApplication 객체를 만든다. 응용프로 
그람이름은 그림기호들의 위치지정，통보문수신 및 환경구성정보의 읽기와 같은 응용프로그 
탐에 고유한 과제들에 사용될수 있다. 

이 프로그람에서는 KDE 객체를 사용하므로 객체를 보관하는 KDE 서고를 포함하여야 한 
다. 전문화된 KDE 서고가 있고 중요한 2개 서고는 Ubkdecore 와 libkdeui 이다. 

INCL= -I$(QTDIR)/include -I$(KDEDIR)/include 
CFLAGS= -02 -fno-strength-reduce 

LFLAGS= -L$(QTDIR)/lib -L$(KDEDIR)/lib -L/usr/XllR6/lib 

LIBS= -lkdecore -lkdeui -lqt -1X11 -lXext -ldl 

CC=g++ 

hellokde: hellokde.o 

$(CC) $(LFLAGS) -o hellokde hellokde.o $(LIBS) 
hellokde.o: hellokde.cpp 

rm -f hellokde 
rm -f hellokde.o 
.SUFFIXES: .cpp 
.cpp.o: 

$(CC) -c $(CFLAGS) $(INCL) -o $@ $< 

LIBS 정의는 KDE 의 핵심기능이 들어있는 서고 libkdecore.a 와 KDE 창문부품들이 모두 들 
어있는 UWcdeuLa 를 포함한다는것을 보여준다. KDE 는 ODBC 구동프로그람들을 동적적재하여 
내부적으로 0 DBC (0 pen Database Connectivity ) 를 실현하므로 서고 libdl.a 를 포함하여 야 한다. 
KDE 를 설치할 때 이 서고를 기 정등록부에 배치하므로 LFLAGS 에 새로운 람색 경 로를 추가 
할 필요는 없다. 


제3절. 간단한 창문클라스 

다음 실례는 자체의 창문부품을 만드는 기본형식을 보여준다. 이 프로그람은 그림 2-3 
에 보여 주는것 처 럼 MyLabel 창문부품을 만들어 기 본창문에 현시한다. MyLabel 창문부품은 매 
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우 간단하다. 그것은 QLabel 의 모두를 계승하며 어떠한 기능도 추가하지 않는다. 클라스선언 
은 머리부파일 mylabel.h 에 있다. 


1 /* mylabel.h */ 

2 #ifndef MYLABEL_H 

3 #defme MYLABEL_H 


5 #include <qlabel.h> 

6 #include <qstring.h> 

7 

8 class MyLabel: public QLabel 

9 { 

10 public: 

11 MyLabel(QWidget *parent); 

12 -MyLabelQ ； 


15 #endif 



그림 2-3. 창문부품의 창조와 현시 

2,3 및 15행의 앞처리지령들은 반드시 필요한것은 아니지만 아주 편리하다. 응용프로그 
탐이 더 복잡해질 때 다른 머리부과일들안에 머리부파일들을 포함하는것이 일반적이므로 같 
은 머 리부파일이 하나의 원천파일에 여 러 번에 걸쳐 포함될수 있다 . 정의 함으 

로써 이 머리부는 여러번 포함될수 있지만 오직 한번 콤파일된다. 

8행에서 MyLabel 클라스의 선언은 기초클라스로서 QLabel 을 사용한다. 이것은 5행의 
include 지 령 이 QLabel 의 선 언을 유효하게 만들기 위 한것 이 다. 머 리부파일 qstring.h 는 QString 
의 선언이 MyLabel 구성자에 요구되므로 6행에 포함한다. MyLabel 클라스는 자기의 원천파일 
에 실현된다. MyLabel 의 구성자로부터 QLabel 기초클라스의 구성자에로 부모창문부품의 주소 
를 넘기는것외에 다른 일을 하지 않는다. 

1 /* mylabel.cpp */ 

2 #include "mylabeLh" 

3 

4 MyLabel :: MyLabel(QWidget *parent) : QLabel(parent) 

5{ 

6} 

7 MyLabel: :~MyLabelO 

8 { 

9} 

23 






다음의 실례는 MyLabel 창문부품을 만들어 현시 한다. 리 용하는 객체를 제외 하고 이 프 
로그람의 main () 함수는 이전 실례와 거의 갈다. 

1 /* helloobject.cpp */ 

2 #include "mylabel.h” 

3 #include <qapplication.h> 

4 

5 int main(int argc, char **argv) 

6 { 

7 QApplication app(argc, argv); 

8 MyLabel *mylabel = new MyLabel(NULL); 

9 QString string( M Hello, object"); 

10 mylabel->setT ext(string); 

11 mylabel->setAlignment( 

12 Qt::AlignVCenter | Qt::AlignHCenter); 

13 mylabel->setGeometry(0,0,l 80,75); 

14 mylabel- 〉 show(); 

15 app. setMainW idget(mylabel); 

16 retum(app.exec()); 

17} 

MyLabel 객체는 이전 실례에서 QLabel 객체와 같은 방법으로 정의되고 조작되고 현시된 
다. setAlignment () 함수는 QLabel 로부터 직접 계승되고 setGeometry () 와 show () 는 QWidget 로부 
터 계승된다. 

알아두기: 객체지향프로그람작성은 많은 우점을 가지고 있으나 가장 잘 알려진것은 
도형방식 사용자대 면 부 ( GUI ) 의 우점 들이 다. Qt 는 이 려 한 우점 을 리 용한다. 현시 가능한 
모든 객체는 기초클라스 QWidget 로부터 기본기능을 계승한다. 그것은 현시가능한 모 
든 창문 즉 표식 자, 단추，제 일 웃준위창문, 기 타 모두가 크기 , 색，유표모양，마우스탐 
지 와 스크롤 등을 조종하는 기 본함수들의 꼭갈은 모임 을 가진다는것 을 의 미한다. 이 
것은 자체의 창문부품들을 쉽게 만들뿐아니라 자동적으로 화면우의 모든것에 대하여 

통일적 인 기정동작과 외관을 적용할수 있게 한다. _ 

makefile 은 이전의 실례와 거의 같지만 두개의 개별적인 .cpp 파일들을 콤파일하고 모두 
련결 한다. 

INCL= -I$(QTDIR)/include -I$(KDEDIR)/include 

CFLAGS= -pipe -02 -fiio-strength-reduce 

LFLAGS= -LS(QTDIR)/lib -LS(KDEDIR)/lib -L/usr/XllR6/lib 

LIBS= -lqt -1X11 -lXext 

CC=g++ 

helloobject: helloobject.o mylabel.o 

$(CC) $(LFLAGS) -o helioobject helloobject.o \ 

mylabel.o $(LIBS) 

helloobject.o: helloobject.cpp mylabel.h 
mylabel.o: my label, cpp mylabel.h 
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rm -f helloobject 
rm -f my label, o 
rm -f helloobject.o 
.SUFFIXES: .cpp 


$(CC) -c $(CFLAGS) $(INCL) -o $@ $< 


제 4 절. 복합참문부품 

(^Application 객 체 는 assignMainWidget() 메 쏘드의 호출에 의 해 할당되 는 창문부품을 응용 
프로그람의 기본창문으로서 현시한다. 둘이상의 항목을 포함하는 기본창문을 현시하기 위하 
여 자체의 창문부품을 만들고 그것을 사용하여 기 본창문으로 현시한다. 다음의 실례는 두 
단추와 표식자를 하나의 창문부품에 결합한다. 

1 /* threewidget.h */ 

2 #ifndef THREEWIDGET—H 

3 #defme THREEWIDGET—H 

4 

5 #include <qpushbutton.h> 

6 #include <qlabel.h> 

7 

8 class ThreeWidget: public QWidget 

9 { 

10 public: 

11 ThreeWidget(QWidget *parent=0,const char *name=0); 

12 private: 

13 QPushButton *topButton; 

14 QPushButton *bottomButton; 

15 QLabel *label; 

16 }； 


18 #endif 

5 행과 6 행은 합성창문부품에 포함되 여야 할 창문부품들을 선언하는 머리부파일들을 포 
함한다. 거기에 2개의 단추와 하나의 표식자가 있다. 그리고 그것들의 주소를 보관하는 위치 
들은 threewidget.h 의 13〜15행에서 비공개자료로서 정의된다. 

1 /* threewidget.cpp */ 

2 #include "threewidget.h" 

3 

4 Three Widget: : ThreeW idget(Q Widget *parent,const char *name): 

5 QWidget(parent,name ) 

6 { 

7 setMinimumSize( 120,180); 

8 setMaximumSize(120,180); 
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10 topButton = new QPushButton( M Top Button”,this); 

11 topButton->setGeometry(15,15,90,40); 

12 label = new QLabel("Middle Label",this); 

13 label->setGeometry(15,70,90,40); 

14 label->setAlignment(AlignVCenter | AlignHCenter); 

15 bottomButton = new QPushButton( M Bottom Button",this); 

16 bottomButton->setGeometry(15,125,90,40); 

17} 

Three Widget 클라스는 현시가능한 창문부품이여야 하므로 기초클라스로서 QWidget 를 사 
용한다. 

7행과 8행은 창문부품의 최소 및 최 대크기 를 설정한다. 부모창문은 그것 이 포함하는 창 
문부품이 크기 를 설정할것을 요구한다. 이 실례 에서 최 소 및 최 대의 설정값은 창문크기 가 
고정된다는것을 의미한다. 그림 2-4 에 보여주는 현시창문은 마우스로 너 비와 높이를 변경할 
수 없다. 



그림 2-4. 단추와 표식자들의 위치와 크기 지정 

제일 우의 단추는 10행에서 만들어진다. 구성자의 둘째 인수는 단추의 부모창문부품이 
다. 이 실례에서 부모는 구성하는 새로운 창문부품이다. 같은 부자관계는 12행과 15행에서 
표식자와 다른 단추에도 수립된다. 

현재 만든 창문부품은 120화소너비와 180화소높이의 현시가능구역을 가진다. 창문부품들 
은 setGeometryO 호출에 의해서 창문에 배치된다. 11행에서 setGeometryO 호출은 웃끝으로부터 15 
화소, 왼쪽에서 15화소에 배치하며 80화소너비와 40화소높이로 단추를 설정한다. 마찬가지로 
13과 16행에서 setGeometryO 호출은 다른 창문부품들을 배치한다. setGeometryO 에 대한 첫 2개 
인수는 왼쪽웃구석이고 2번째의 2개 인수는 너비와 높이이다. 

이 프로그람의 main () 함수는 새로운 합성 창문부품을 마치도 다른 창문부품인것처 럼 취 
급한다. 

1 /* compound.cpp */ 

2 #include <qapplication.h> 

3 #include "threewidget.h" 
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5 int main(int argc, char **argv) 

6 { 

7 QApplication app(argc, argv); 

8 ThreeWidget threeWidget; 

9 threeWidget. setGeometry(10,10,100,100); 

10 app. setMainWidget(&three Widget); 

11 threeWidget.showO ； 

12 retum(app.exec()); 

13} 

threeWidget 객체는 8 행에서 만들어진다. 창문부품은 유효하지 않은 크기에 맞추도록 강 
요할수 없으므로 9행의 setGeom 的 y () 호출은 창문부품에 최소 및 최대크기설정으로 인한 영 
향이 없다. 11행에서 show () 호출은 창문부품과 그것이 포함하는 모든 창문부품들을 현시하도 
륵 지 시한다. 


제5절. 단추 

단추는 창문부품이므로 다른 창문부품처럼 현시될수 있다. 그러나 프로그람은 언제 사 
용자가 단추를 찰칵하는지 알고있어야 한다. 다음의 실례는 그림 2-5 에 보여주는 창문을 현 
시하고 단추사건에 응답하여 완료한다. 

1 /* exitbutton.cpp */ 

2 #include <qapplication.h> 

3 #include <qpushbutton.h> 

4 #include <qstring.h> 

5 

6 int main(int argc, char **argv) 

1 { 

8 QApplication app(argc, argv); 

9 QString string (” Exit”); 

10 QPushButton *button = new QPushButton(string,NULL); 

11 QObject: : connect(button, 

12 SIGNAL(clicked()),&app,SLOT(quit0 ))； 

13 button->setGeometry(0,0,80,50); 

14 button->show0 ； 

15 app. setMainWidget(button); 

16 retum(app.exec()); 

17} 

l 響 ^ _ 

|l 빼 | I 

그림 2-5. 프로그람을 완료하는 단추 
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단추는 마우스사건에 응답할 준비가 되여있지만 단추가 프로그람의 어떤 부분에 통보 
문을 보내도록 지시하지 않는 한 응답사건이 발생하지 않는다. 이런 형의 통보문을 신호라 
고 부르며 신호를 받아들이는 메쏘드를 처 리부라고 한다. 11 행과 12 행에서 QObject::connect() 
에 대한 호출은 신호의 사본이 단추안의 clickedO 로부터 응용프로그람의 quit() 메쏘드로 보내 
지게 한다. 

알아두기: 다른 사건구동체계 에서 작업한적 이 있다면 아마 역 호출함수개 념 에 익 숙되 
였을것이다. 처리부는 역호출과 류사하지만 차이가 있다. 가장 중요한 차이는 처리부 
들이 형안전한것이다. 인수형들이 서로 조화되지 않으면 프로그람은 콤파일되지 않는 
다. 

QObject::connect() 호출에서 단추의 clicked() 메쏘드를 신호의 원천으로 지정한다. 신호는 
그것을 받을 처리부함수모임이 있든 없든 발송된다. 또한 여러개의 처리부들이 신호를 받도 
록 설정되였으면 그것들은 각각 신호의 사본을 받는다. 

QObject::connectO 호출에서 둘째 쌍의 인수들은 받는 처리부가 QApplication 의 quit() 이라 
는것 을 지 정 한다. 


제6절. 신호용처리부의 정의 

창문부품이 신호를 밤도록 하기 위하여서는 처리부를 선언한 다음 신호에 련결해야 한 
다. 그림 2-6 에서 보여주는 다음 실례는 단추와 계수기를 현시하고 단추를 누를 때마다 계수 
기를 증가시킨다. 이것을 발생시키는데 몇가지 필요한것이 있지만 Qt 체계가 그 세부분을 거 
의 조종한다. 특히 세부적인 작업을 자동적으로 처리하기 위한 특수마크로들과 메타객체를 
파일러 (Meta Object Compiler , MOC ) 가 있다. 이 실례의 mainO 함수는 간단히 창문부품을 만들 
고 현시한다. 

1 /* count, cpp */ 

2 #include <qapplication.h> 

3 #include "clickcount.h" 

4 

5 int main(int argc, char **argv) 

6 { 

7 QApplication app(argc, argv); 

8 ClickCount clickcount; 

9 app. setMainW idget(&clickcount); 

10 clickcount. show(); 

11 retum(app.exec()); 
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그림 2-6. 단추의 신호를 받는 계수기의 처리부 
ClickCount 창문부품은 단추와 표식 자를 포함한다. 표식 자는 현재 계 수기값을 현시 하는데 
쓰 인다. 

1 /* clickcount.li */ 

2 #ifndef CLICKCOUNT_H 

3 #defme CLICKCOUNT_H 

4 

5 #include <qpushbutton.h> 

6 #include <qlabel.h> 

7 

8 class ClickCount: public QWidget 

9 { 

10 Q-OBJECT 

11 public: 

12 ClickCount(QWidget *parent=0,const char *name=0); 

13 public slots: 

14 void incrementCounter(); 

15 private: 

16 int counter; 

17 QLabel * label; 

18 QPushButton *button; 

19 }； 

20 

21 #endif 

10 행의 마크로 Q_OBJECT 는 처리부를 가지는 모든 클라스에 존재해야 한다. (또한 5장 
에서 볼수 있는것처럼 신호를 발송하는 클라스에도 있어야 한다.) Q_OBJECT 마크로는 신호 
와 처 리부들이 작업하는데 필요한 표준메 쏘드들을 정 의한다. 

14행에서 incrementCounterC ) 메 쏘드는 13행에서 공개 처리 부로 된 다. incrementCounterO 는 
처리부로 선언되지만 클라스의 다른 메쏘드와 같이 신호로도 호출될수 있고 직접 호출될수 
도 있다. 

ClickCount 클라스의 구성자는 단추와 표식자를 포함하는 배치를 만들고 단추사건으로부 
터 incrementCounterO 라는 이름의 처리부에 신호를 보내는 련결을 만든다. 

1 /* clickcount.cpp */ 
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5 ClickCount: : ClickCount(QWidget *parent,const char *name) : 

6 QWidget(parent,name ) 

7 { 

8 setMinimumSize( 120,125); 

9 setMaximumSize(120,125); 

10 

11 counter = 0; 

12 button = new QPushButton (” Add l M ,this); 

13 button->setGeometry(15,15,90,40); 

14 label = new QLabel(”0” ， this); 

1 5 label->setGeometry(15,70,90,40); 

16 label->setAlignment(AlignVCenter | AlignHCenter); 

17 

18 QObject: : connect( 

19 button,SIGNAL(clicked()), 

20 this, SLOT (incrementCounter())); 

21 } 

22 void ClickCount: : incrementCounter() 

23 { 

24 char str[30]; 

25 sprintf(str, M %d",++counter); 

26 label->setT ext(str); 



8 행과 9 행에서 setMinimumSize () 과 setMaximumSize () 호출은 120 x 125 화소로 창문크기를 
고정시킨다. 계수기값은 11행에서 초기화되고 단추와 표식자는 12〜16행에서 정의된다. 

18행에서 QObjectxonnectO 호출은 신호에 처리부를 련결한다. 19행의 처음 2개 인수는 
신호의 원천 이 clickedO 메 쏘드라는것 을 지 정한다. clickedQ 신호는 pressedQ , released () 및 
toggled () 라는 신호들과 함께 단추클라스의 성원이다. 

| 참고: 5장에서 신호메 쏘드를 만드는 실 례 들을 볼수 있다. | 

20행 에서 QObject :: connect () 인수들의 2번째 쌍은 신호를 받는 객체와 메쏘드를 지 정 한다. 
객체는 this(ClickCount 의 현재 실례)이 고 메쏘드는 incrementCounterO 이 다. 단추사건 에 의 해 
clickedO 신호가 발송될 때마다 incrementCounterO 메쏘드에 의해 받아들이고 현시되는 값에 1 
을 더하고 단추의 본문을 갱신한다. 

알아두기: 신호와 처리부사이에는 사실상 련결이 없다. 신호는 받아들이는 처리부가 
있든 없든 발송되며 신호를 받아들이는 처리부는 여러개 될수도 있다. 또한 처리부는 

임의의 개수의 신호를 받아들이도록 설정될수 있다. _ 

이 실례의 makefile 은 메 타객체 콤파일 러 가 클라스를 선 언하는 머 리부파일의 원천코드로 
서 입력을 처리하고 콤파일하여 프로그람과 련결할 새 원천파일을 생성한다. 






1 INCL= -I$(QTDIR)/include -I$(KDEDIR)/include 

2 CFLAGS= -02 -fiio-strength-reduce 

3 LFLAGS= -L$(QTDIR)/lib -LS(KDEDIR)/include -L/usr/XllR6/lib 

4 LIBS= -lqt -1X11 -lXext 

5 CC=g++ 

6 

7 count: count.o clickcount.o moc clickcount.o 

8 $(CC) $(LFLAGS) -o count count.o clickcount.o \ 

9 moc clickcount.o S(LIBS) 

10 

11 count.o: count.cpp clickcount.h 

12 clickcount.o: clickcount.cpp clickcount.h 

13 moc clickcount. cpp : clickcount.h 

14 S(QTDIR)/bin/moc clickcount.h -o moc clickcount.cpp 

15 

16 clean: 



19 rm -f clickcount.o 

20 rm -f moc_* 

21 

22 .SUFFIXES: .cpp 

23 

24 .cpp.o: 

25 $(CC) -c $(CFLAGS) $(INCL) -o $@ $< 

7 행은 프로그람이 count . o 와 clickount . o 에 의존할뿐아니 라 moc _ clickcount . o 에도 의존한다 
는것 을 보여 준다. 파일 moc _ clickcount . cpp 는 clickcount . h 로부터 MOC 콤파일 러 에 의해 만들어 
진다. Q _ OBJECT 마크로는 ClickCount 클라스선언에 일부 메쏘드원형선언을 추가하고 MOC 를 
파일 러 는 새 로운 메 쏘드의 본체 들을 생 성한다. 결 과 신 호와 처 리 부에 요구되 는 반복(그리 고 
오유판정)코드작성이 거의 완전히 자동화된다. 

참고: 5장에 서 전체 과정 을 시 험한다. I 


요 약 

아주 적 은 코드행 으로 Qt 또는 KDE 응용프로그람을 작성할수 있다. 창문을 만드는 코드 
작성의 세부와 사용자입 력을 받아들이는 저준위기구는 모두 API 내 에서 조종된다. 

- Qt 프로그람은 프로그람의 기본함수에서 QApplication 객체를 만들고 창문을 조종하도록 
작성 한다. KDE 프로그람도 마찬가지 로 KApplication 객 체 를 사용하여 작성 한다. 

• 응용프로그람의 기본창문은 하나의 창문부품이다. 이 창문부품은 보통 정보를 현시하 
고 사용자대면부를 제공하는 다른 창문부품들의 모임을 포함한다. 

• 객체는 하나이상의 신호를 발생할수 있도록 작성될수 있다. 또한 객체는 발생된 신호 
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를 받아들이도록 설계된 하나이상의 처리부를 포함할수 있다. 처리부와 신호실현의 세부는 
마크로들과 MOC 를파일러의 사용을 통하여 자동화된다. 

이 장은 응용프로그람의 기본창문을 만들고 현시하는 방법을 설명하였다. 다음 장은 튀 
여나오기창문과 대화칸을 현시하는 방법을 취급한다. 미리 정의된 KDE 와 Qt 대화칸들이 있 
지만 자체로 창조할수도 있다. 



제 3 장. 창문의 창문부품배치 

학습내용 

현시 기 에서 x ， y 값을 리용한 창문부품들의 위치지정 
살창자리표계와 창문부품들의 결합 
현시기에 적합하게 창문부품들의 확장과 축소 
수직칸에 창문부품들의 쌓기 
수평칸에 창문부품들의 삽입 하는 방법 

이 장은 창문내부에서 창문부품집 합의 크기와 위치를 조종하는 방법을 설명한다. 응용 
프로그람을 시 작할 때 단추와 본문입 력창문부품들을 적 당히 배 렬 하여 표시 하여 야 단추사건 
에 응답하거 나 사용자가 입 력 한 본문을 읽어들일수 있다. 이 장은 창문부품을 필요한 위치 
에 배 치 하는 방법뿐아니 라 창문부품크기 와 창문크기 가 달라질 때 발생 하는 작용을 지 정 하는 
방법을 설명한다. 

창문부품들은 자리표값들에 의하여 혹은 배치를 리용하여 위치와 크기를 지정할수 있 
다. 자리표값들은 사용자가 조절할수 없는 고정된 화소위치들이다. 한편 배치객체는 창문부 
품들호상 및 포함하는 창문의 전체 크기에 따라 최대 및 최소한계내에서 창문부품들의 위치 
와 크기를 조종한다. 


제1절. 장문부품의 기하학적배 치 


4개의 값 수평변이，수직변이，너 비와 높이를 지 정함으로써 매개 창문부품의 정확한 배 
치 와 크기 를 지 정할수 있다. 자리 표계 는 부모창문 즉 창문부품들을 포함하는 창문의 자리 표 
계 이다. 다음 실례는 응용프로그람창문에 3개의 누름단추를 배치한다. 

Main 


1 /* main.cpp */ 

2 #include <kapplication.h> 

3 #include ” setxy.h” 

4 


5 int main(int argc, char **argv) 

6 { 

7 KApplication app(argc, argv, ’’setxy’’); 

8 SetXY setxy; 

9 setxy.show(); 

10 app. setMainW idget (& setxy); 

11 retum(app.exec()); 

12 } 
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기본함수는 아주 간단한다. 머리부파일은 3행에서 포함된다. 8행에서 단추들을 가지는 
창문부품이 만들어 지 고 10행 에서 setMainWidgetO 호출에 의해 기 본응용프로그람창문으로 현 
시되는 창문부품으로 설정된다. 

SetXY 머 리 부파일 

1 /* setxy.h */ 

2 #ifndef SETXY H 

3 #defme SETXY H 


5 #include <qpushbutton.h> 

6 

7 class SetXY: public QWidget 

8 { 

9 public: 

10 SetXY(QWidget *parent=0,const char *name=0); 

11 〜 SetXY(); 

12 private: 

13 QPushButton *buttonl; 

14 QPushButton *button2; 

15 QPushButton *button3; 

16 }； 


18 #endif 

클라스 SetXY 는 QWidget 를 기초클라스로 하여 선언된다. 자료는 13〜15행에서 정의된 
3개의 QPushButton 지적자이다. 보통 단추사건들에 응답하는 처리부로 지정되는 메쏘드가 있 
을수 있지만 이것은 간단한 배치를 보여주는 실례이므로 단추사건들에 응답하지 않는다. 
알아두기 : setxy.h 의 5행 에 서 포함되 는 머 리 부파일 qpushbutton.h 는 자동적 으로 setxy.cpp 
와 mainxpp 에도 포함된다. 또 하나의 창문부품을 사용하는데 그 창문부품도 역시 
qpushbutton.h 를 포함한다면 같은 머리부파일은 두번 포함된다 . 2, 3, 18행의 사전를파일 
러지령들은 머리부파일이 여러번 콤파일되는것을 막는데 쓰인다. 

SetXY 

1 /* setxy.cpp */ 

2 #include ” setxy.h” 


4 SetXY :: SetXY (QWidget *parent,const char *name) 

5 : QWidget(parent,name) 

6 { 

7 setMinimumSize(90,40); 
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8 setMaximumSize(l 90,220); 

9 resize(190,220); 

10 

11 button 1 = new QPushButton( M Upper Left",this); 

12 button 1 - >setGeometry(0,0,90,40); 

13 

14 button2 = new QPushButton("Middle Right”,this); 

15 button2 - >setGeometry(90,70,100,50); 

16 

17 button3 = new QPushButton("Bottom",this); 

18 button3 ->setGeometry(45,140,50,80); 

19} 

20 SetXY::~SetXY0 { } 

SetXY 가 수행하는 모든 작업은 구성자에서 진행된다. 그림 3-1 에서 보여주는것처럼 3개 
의 단추가 정의되고 현시된다. 



그림 3-1. 자리표에 따라 배치된 3개의 단추들 
11행에서 왼쪽웃구석에 있는 단추가 만들어지고 12행에서 그 크기와 위치가 설정된다. 
setGeometry () 에 넘긴 4개 옹근수의 순서는 다음과 같다. 

x ， y ， width ， height 

거리는 화소로 계산된다. X 값은 응용프로그람창문의 왼끝으로부터 포함된 창문부품의 
왼끝까지 의 화소수이 다. y 값은 창문의 웃끝으로부터 창문부품의 웃끝까지 의 화소수이 다. 즉 
왼쪽웃구석 은 자리 표계의 원점 이 다. 매 개 단추를 만든 다음 setGeomrtryO 호출에 의 해 크기 와 
위치가 설정된다. 

알아두기: 2개 창문부품이 갈은 공간을 차지하도록 배치하면 새로운 창문부품이 낡은 

창문부품을 가리운다. _ 

7, 8, 9행의 호출은 창문부품을 현시하는 규칙들을 정의한다. 7행의 setMinimumSize () 호출은 
창문부품이 적어도 90 x 40 화소 크기로 현시되여야 한다는것을 지정한다. 창문부품은 사용자가 설 
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정한 크기로 창문에 현시되므로 최소설정값은 중요하다. 창문부품은 그림 3-2 에서 보여주는 크 
기이상으로 줄어들수 없다. 8행의 setMaximumSizeO 호출은 창문부품의 높이와 너비에 대한 웃한 
계를 설정한다. 끝으로 9행의 resizeO 호출은 창문부품의 초기크기를 최대허용크기로 설정한다. 



그림 3-2. 3개 단추중 2개 를 볼수 없게 하는 최 소크기 설정 
20행의 〜 SetXY () 해체자에서는 응용프로그람은 완료되고 창문부품은 파괴되므로 아무것 
도 수행할것이 없다. 또한 이 창문부품이 단추들의 부모이므로 3개 단추를 해체한다. 

제2절. 창문부품의 크기 

창문에서 창문부품들을 배치할 때 2가지 중요한 인자를 고려해 야 한다. 매개 창문부품 
은 위치와 크기를 가지고있다. 이전 실례에서 위치와 크기는 응용프로그람에 의해 완전히 
조종된다. 응용프로그람이 자세한 조종준위를 요구하면 좋지만 대부분의 창문부품들은 크기 
에 대한 자기의 요구를 가지고있다. 

QWidget 의 수많은 메쏘드들은 창문부품의 크기에 대한 조종을 사용자에게 넘겨준다. 
이려한 메쏘드들의 일부는 높이와 너비값을 사용하고 일부는 QSize 객체를 사용하지만 그것 
들은 모두 갈은 일을 한다. QSize 클라스는 간단히 높이와 너비를 포함하지만 크기조작이 복 
잡해질 때 조작을 훨씬 더 쉽게 하는 메쏘드와 연산자들도 포함한다. 실례로 비례에 따라 
크기를 변경하는 연산자와 두개의 QSize 객체를 하나로 결합하는 연산자를 리용할수 있다. 
void setMaximumSize(const QSize &qsize); 
void setMaximumSize(int width,int height); 
void setMaximumWidth(int width); 
void setMaximumHeight(int height); 
void setMinimumSize(const QSize &qsize); 
void setMinimnmSize(mt width，int height); 
void setMinimumWidth(int width); 
void setMinimumHeight(int height); 

창문부품이 고정크기를 가져야 한다면 2개의 함수를 만들어 최소값과 최대값을 갈은 
값들로 설 정 하거 나 다음 함수들중 하나를 호출하여 설 정할수 있다. 

void setFixedSize(const QSize &qsize); 
void setFixedSize(int width,int height); 
void setFixedWidth(int width); 
void setFixedHeight(int height); 

다음의 함수들은 최소크기와 최대크기를 얻는다. 

QSize maximumSizeO ； 

QSize minimumSize(); 
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제 3 절. 고정살참창문부품배치 

QGridLayout 객체의 사용은 보이지 않는 수평선과 수직선들로 이루어진 살창을 정의하 
고 세포들에 창문부품들을 삽입할수 있게 한다. 다음 실례는 5 x 5 세포 크기로 살창을 만들고 
4개 세 포에 단추를 삽입한다. 

Main 

1 /* main.cpp */ 

2 #include <kapplication.h> 

3 #include ” fivebyfive 上 ” 

4 

5 int main(int argc, char **argv) 

6 { 

7 KApplication app(argc, argv, "fivebyfive"); 

8 FiveByFive * fivebyfive = new FiveByFiveO ； 

9 fivebyfive- 〉 show〔); 

10 app. setMainWidget(fivebyfive); 

11 retum(app. exec()); 

12} 

기본함수는 FiveByFive 창문부품의 실례를 만들고 그것을 KApplication 창문에 현시하는 
창문부품으로 사용한다. 결과는 그림 3-3 에 현시된 창문이다. 



그림 3-3. 살창배 치 에 의 한 4개 누름단추의 배 치 
FiveByFive 머 리 부파일 
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2 #ifndef FIVEBYFIVE_H 

3 #defme FIVEBYFIVE_H 

4 

5 #include <qwidget.h> 

6 #include <qpushbutton.h> 

7 

8 class FiveByFive: public QWidget 

9 { 

10 public: 

11 FiveByFive(QWidget *parent=0,const char *name=0); 

12 〜 FiveByFive(); 

13 private: 

14 QPushButton *bll; 

15 QPushButton *b31; 

16 QPushButton *bl3; 

17 QPushButton *b33; 

18 }； 

19 

20 #endif 

머리부파일은 FiveByFive 클라스를 QWidget 의 파생클라스로 선언하고 살창에 4개 단추 
를 포함한다. 

FiveByFive 

1 /* fivebyfive.cpp */ 

2 #include <qlayout.h> 

3 #include ’’fivebyfive.h” 

4 

5 FiveByFive: :FiveByFive(QWidget *parent,const char *name) 

6 : QWidget(parent,name) 

1 { 

8 QGridLayout * layout = new QGridLayout(thi s, 5,5); 

9 

10 bll = new QPushButton( M ( 1,1 ) M ,this); 

11 bll - >setMaximumSize(100,100); 

12 layout->addWidget(b 11,1,1); 

13 bl3 = new QPushButton( M (l,3) M ,this); 

14 b 13 - >setMaximumSize(100,100); 

15 layout->addWidget(bl 3,1,3 )； 

16 b31 = new QPushButton( M (3,1 ) M ,this); 

17 b31 ->setMaximumSize(100,100); 

18 layout->addWidget(b31,3,1); 

19 b33 = new QPushButton(”(3,3)” ， this); 

20 b33 - >setMaximumSize(100,100); 

21 layout->addWidget(b33,3,3 )； 


38 





23 for(int i=0; i<5; i_H_) { 

24 layout->addRowSpacing(i,60); 

25 layout->addColSpacing(i,60); 

26 } 

27 resize(10,10); 

28 

29 layout->activate(); 

30} 

31 

32 FiveByFive: :~FiveByFive() { } 

파일 qlayouth 는 2 행에서 포함된다. 또한 이 머리부파일은 이 장의 뒤에 설명하는 
QVBoxLayout 와 QHBoxLayout 를 선언하는데 사용된다. 

8 행에서 만들어진 QGridLayout 객체는 5><5 세포의 크기를 가진 다. 왼쪽웃구석의 세포는 
(0,0) 이고 그 오른쪽이 (0,1), 다음것이 (0,2),--. 왼끝에서 하나 옆에, 우로부터 하나 아래에 
놓이 도록 창문부품을 살창에 배 치 하기 위 하여 살창세 포 (1,1) 에 설 정한다. 

10행 과 11행 은 단추를 만들고 그 최 소높이 와 최 소너 비 를 모두 100화소로 설 정한다. 이 
것은 단추가 자기에게 할당된 세포가 100 X 100 화소보다 작지만 세포가 꽉 차도록 단추를 확 
장하게 한다. 보통 단추는 그 내부최대설정값이상 늘일수 없다. 

10, 11, 12행은 표식자 "(1, 1)” 을 가지는 단추를 만들어 위치 ( U ) 의 살창세포에 배치한 
다. 11 행 의 setMaximumSizeO 호출은 단추가 들어 있는 세 포가 꽉차도록 단추를 확장한다. 
sizeHintO 메쏘드는 모든 창문부품에 사용할수 있는것은 아니다. 이 경우에 QPushButton 창문부 
품이 유효크기암시를 돌려주는것으로 정확히 가정되 므로 그것 이 사용되기전에 유효성검사가 
실시되지 않는다. 일반화된 코드형식은 다음과 갈다. 

QSize *qsize = bll.sizeHint(); 

if(qsize.isValid()) 

b 11. setMinimumSize(qsize); 

bll. setMinimumSize(30,30); 

이리하여 검사하는 창문부품이 유효크기설정을 돌려주지 않으면 적당한 값이 사용된다. 
기정설정은 매우 좋지만 결코 사용자가 요구하는 정확한 값은 아니다. 

알아두기: 자체의 창문부품을 작성할 때 sizeHintO 를 실현하는것이 효과적일수 있다. 
sizeHint() 는 QWidget 에서 가상함수로 선언되며 그것을 재정의하지 않는한 무효한 
QSize 를 돌려준다. 

23 〜 26 행의 순환은 살창의 매개 행과 렬에 대하여 addRowSpacingO 을 호출하여 매개 렬 
의 최 소너 비 와 매 개 행 의 최 소높이 를 각각 60 화소로 설 정한다. 최 대 값을 설 정 하지 않으면 
매개 행과 렬은 임의의 크기까지 늘어날수 있으며 창문크기를 변경하면 단추들의 크기도 변 
경된다. 

31 행의 resizeO 호출은 10x10 화소로 창문부품을 줄일것을 요구하지만 창문부품은 행과 
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렬의 최소크기때문에 그 요구를 받아들일수 없다. 창문부품이 자체의 크기를 변경할데 대한 
지령을 받았는데 새로운 높이나 너비가 최대 또는 최소 한계를 벗어날 때에 요구된 값은 무 
시되고 가장 가까운 유효값 즉 최대값 또는 최소값이 리용된다. 이 실례에서 창문부품은 간 
단히 그 최소크기로 줄어든다. 

제4절. 가변살창창문부품배치 

다음 실례는 QGridLayout 객체를 사용하여 4 개 단추를 배치하고 부모창문의 크기가 변 
경될 때 단추들의 크기를 조종하는 행과 렬의 가변값들을 설정한다. 

Main 

1 /* main.cpp */ 

2 #include <kapplication.h> 

3 #include M fourbyfour.h M 

4 

5 int main(int argc, char **argv) 

6 { 

7 KApplication app(argc, argv, "fourbyfour"); 

8 FourByFour *fourbyfour = new FourByFour(); 

9 fourbyfour->show(); 

10 app. setMainW idget(fourby four); 

11 retum(app. exec()); 

12} 

기본함수는 FourByFour 창문부품의 실례를 만들고 그것을 KApplication 창문에 현시하는 
창문부품으로 사용한다. 

FourByFour 머 리 부파일 

1 /* fourbyfour.h */ 

2 #ifndef FOURBYFOUR_H 

3 #defme FOURBYFOUR_H 

4 

5 #include <qwidget.h> 

6 #include <qpushbutton.h> 

7 

8 class FourByFour: public QWidget 

9 { 

10 public: 

11 FourByFour(QWidget *parent=0,const char *name=0); 

12 〜 FourByFourO; 

13 private: 

14 QPushButton*bll; 

15 QPushButton *b21; 

16 QPushButton *bl2; 

17 QPushButton *b22; 
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18 }； 


19 

20 

21 #endif 

머리부파일은 크기를 조종하는 세포들에 배치할 4개의 단추들을 비공개자료로 포함하 
는 QWidget 로서 FourByFour 클라스를 선언한다. 

FourByFour 

1 /* fourbyfour.cpp */ 

2 #include <qlayout.h> 

3 #include ” fourbyfour.h” 

4 

5 FourByFour: :FourByFour(QWidget *parent,const char *name) 

6 : QWidget(parent,name) 

7 { 

8 QGridLayout * layout = new QGridLayout(this,4,4); 

9 QSize buttonMax(400,400); 

10 

11 bll = new QPushButton(this); 

12 bll- 〉 setText(’ ， (l ， l)”); 

13 bll - >setMinimumSize(b 11 - >sizeHint()); 

14 bll - >setMaximumSize(buttonMax); 

15 layout->addWidget(bl 1,1,1 )； 

16 bl2 = new QPushButton(this); 

17 bl2 - >setText( M (l,2) M ); 

18 b 12->setMinimumSize(b 12 - >sizeHint()); 

19 b 12 - >setMaximumSize(buttonMax); 

20 layout->addWidget(bl2,l,2); 

21 b21 = new QPushButton(this); 

22 b21->setText( M (2,l) M ); 

23 b21 - >setMinimumSize(b21 - >sizeHint()); 

24 b21 - >setMaximumSize(buttonMax); 

25 layout->addWidget(b21,2,l )； 

26 b22 = new QPushButton(this); 

27 b22 - >setText( M (2,2) M ); 

28 b22 - >setMinimumSize(b22 - >sizeHint()); 

29 b22 - >setMaximumSize(buttonMax); 

30 layout->addWidget(b22,2,2); 

31 

32 layout->addRowSpacing(0,20); 

33 layout->addRowSpacing(3,20); 

34 layout->addColSpacing(0,20); 

35 layout->addColSpacing(3,20); 

36 resize(10,10); 

37 

38 layout->setRowStretch(2,100); 
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39 layout->setColStretch(2,100); 

40 

41 layout->activate(); 

42} 

43 

44 FourByFour::~FourByFourO { } 

8 행에서 4X4 세포크기로 QGridLayout 객체가 만들어진다. 11 〜 30 행은 4 개의 QPushButton 
객체를 만들어 살창의 4 개의 중심세포에 추가한다. 매개 단추의 최소크기는 본문을 항상 볼 
수 있는 값으로 설정된다. 매개 단추의 최대크기는 세포들을 채우는데 필요한만큼 
QGridLayout 가 단추들을 늘일수 있도록 일정하게 큰수로 설정된다. 

32 〜 35 행의 addRowSpacing() 과 addColSpacing() 호출은 좌우측 렬들의 너 비와 우아래행들 
의 높이 를 20화소로 각각 설정한다. 결과는 단추들을 담고있는 응용프로그람창문의 경 계와 
중심 의 4 개 세포사이 의 20 화소여 백 이 다. 36 행의 resize() 호출은 최 소허 용값보다 작은 크기 로 
창문부품을 줄이려고 하므로 창문부품은 처음에 최소허용크기로 현시된다. 결과는 그림 3-4 
에 보여준다. 



그림 3-4. 매개가 최소크기 4를 가지는 4개 창문부품 
38행의 setRowSttetchO 호출은 3번째 행(단추들의 둘째 행)의 가변곁수를 100으로 설정한 
다. 34행의 setColStretchO 호출은 3번째 렬(단추들의 두번째 렬)의 가변곁수를 1W 으로 설정한 
다. 창문의 수직크기 또는 수평크기가 바뀔 때마다 큰 가변곁수를 가지는 행과 렬들은 작은 
가변곁수를 가지는것들보다 더 많이 변경된다. 

기정가변값은 매개 행과 렬에 대하여 0이다. 행(또는 렬)들에 대하여 모두 0으로 설정 
되 면 모든 행(또는 렬)의 크기 를 변경할수도 있고 변경 하지 않을수도 있다. 이 기 정값은 대 
체로 사용자가 요구하는 값이 아니다. 살창의 크기가 달라질 때 령아닌 값을 가지는 행과 
렬들만 그에 따라 크기 가 달라진다. 행 또는 렬의 크기변경량은 그 행 또는 렬의 가변곁수 
와 크기변경되는 모든 세포들의 가변곁수들의 합의 비률에 의해 결정된다. 

이 실례에서 창문을 확장하면 그림 3-5 에 보여주는것과 같이 현시된다. 렬1과 행1의 가 
변곁수들은 0으로 남아있으므로 왼쪽웃구석의 단추는 변경되지 않은 상태로 남아 있다. 다 
른 한편 렬2와 행2는 모두 령 아닌 값을 가지므로 오른쪽아래의 세포에 있는 단추는 량방향 
으로 크기가 변경된다. 
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그림 3-5. 가변곁 수의 영 향을 받은 각이한 크기변 경 
세포가 실제로 확장되는 크기는 세포의 가변곁수와 변화되는 방향의 모든 가변곁수들 
의 합의 비률에 의해 결정된다. 실례로 FourByFour 의 가변곁수변경은 모든 단추들의 크기를 
변경하지만 일부는 다른것들보다 더 빨러 변경된다. 실례로 33행과 34행을 다음과 같이 교 
체 한다. 

layout->setRowStretch(l ,50); 
layout->setRowStretch(2, 1 00); 
layout->setColStretch(l ,9); 
layout->setColStretch(2,1); 

이 환경 설정값에 의 하여 창문을 수직 으로 늘이면 행1의 높이 는 행2 보다 두배 증가한 
다. 창문을 수평으로 늘이면 렬1는 렬2의 9배로 증가한다. 창문확장결과는 그림 3-6 에 보여 
준다. 




그림 3-6. 가변곁수를 가지는 매개 행과 렬 


제5절. 살창의 여러 세포를 차지하는 창문부품 

QGridLayout 는 장기판과 같은 직4사각형베렬에 창문부품들을 배치하는데 사용될수 있 
으며 창문부품이 2개이상의 바른4각형의 살창을 차지하게 할수 있다. 다음 실례는 표식자가 
창문의 웃부분을 가로질러 적당히 놓이도록 하고 목록칸은 6개 세포의 위치를 차지하게 한 
다. 
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1 /* main.cpp */ 

2 #include < kapplication . h > 

3 #include " multicell . h ’’ 

4 

5 int main(int argc , char ** argv ) 

6 { 

7 KApplication app ( argc , argv , " multicell "); 

8 MultiCell *multicell = new MultiCell (); 

9 multicell -> show (); 

10 app . setMainWidget ( multicell ); 

11 retum ( app . exec ()); 

12 } 

MultiCell 머 리 부파일 

1 /* multicell 上 */ 

2 #ifndef MULTICELL_H 

3 #define MULTICELL_H 

4 

5 #include < qwidget . h > 

6 #include < qpushbutton . h > 

7 #include < qlabel . h > 

8 #include < qlistbox . h > 

9 

10 class MultiCell : public QWidget 

11 { 

12 public : 

13 MultiCell(QWidget * parent =0 ,const char * name =0); 

14 〜 MultiCell (); 

15 private : 

16 QLabel * label ; 

17 QListBox * listbox ; 

18 QPushButton * addButton ; 

19 QPushButton * deleteButton ; 

20 QPushButton * cancelButton ; 


21}； 



22 

23 #endif 

16 〜 20 행에서 서로 다른 모든 창문부품들의 지적자들을 MultiCell 클라스의 자료성원으 
로 정 의한다. 이 것은 6〜8행 에 창문부품의 머 리 부파일 이 있어 야 한다는것을 의 미한다. 
알아두기: 클라스선언에서 모든 창문부품에 대하여 지적자를 포함하는것은 아주 례사 
로운 일 이 지만 늘 그러한것은 아니 다. 일단 창문부품의 현시환경 이 구성되 였으면 어 
떤 구체적인 상황에서 지적자를 요구하지 않는한 프로그람이 그것을 기억할 필요는 
없다. 실례로 자기 프로그람이 표식자본문을 변경하거나 목록칸에 성원들을 추가하려 
고 한다면 그 지적자들을 호출해야 한다. 

MultiCdl. 

1 /* multicell.cpp */ 

2 #include < qlayout . h > 

3 #include < stdio . h > 

4 #include " multicell . h " 

5 

6 MultiCell : : MultiCell(QWidget ^ parent,const char * name ) 

7 : QWidget ( parent , name ) 

8 { 

9 QGridLayout *layout = new QGridLayout ( this ,4,2,20); 

10 

11 label = new QLabel(’’A list box with three buttons ", 

12 this ); 

13 label -> setMinimumSize ( label -> sizeHint ()); 

14 label -> setAlignment ( AlignHCenter ); 

15 layout -> addMultiCellWidget ( label ,0,0,0, l ); 

16 

17 listbox = new QListBox ( this ); 

18 for(int i =0; i <20; i ++) { 

19 char str [40]; 

20 sprintf ( str , "Selection % d \ n ", i ); 

21 listbox -> insertItem ( str ); 

22 } 

23 listbox -> setMinimumWidth ( 120); 

24 layout -> addMultiCellWidget ( listbox , 1,3,0,0); 

25 
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26 addButton = new QPushButton ( this ); 

27 addButton->setT ext (" Add n ); 

28 addButton -> setMinimumSize ( addButton -> sizeHint ()); 

29 layout -> addWidget ( addButton , 1,1); 

30 

31 deleteButton = new QPushButton ( this ); 

32 deleteButton -> setText ( M Delete M ); 

33 deleteButton -> setMinimumSize ( deleteButton -> sizeHint ()); 

34 layout -> addWidget ( deleteButton ,2,1); 

35 

36 cancelButton = new QPushButton ( this ); 

37 cancelButton -> setText (" Cancer '); 

3 8 cancelButton -> setMinimumSize ( cancelButton -> sizeHintO )； 

39 layout -> addWidget ( cancelButton ,3,1); 

40 

41 resize (10,10); 

42 layout -> activate (); 

43} 

44 

45 MultiCell ::~ MultiCell () { } 

9 행에서 QGridLayout 는 4 x 2 세포크기로 구성된다. 또한 경계값 20은 모든 세포들사이에 
간격을 삽입하는데 사용된다. 현시된 창문을 그림 3-7 에 보여준다. 



그림 3-7. 여러개의 살창세포들을 차지하는 창문부품들 
11〜14행은 본문을 가지는 표식자를 정의하고 최소크기를 설정하며 본문이 수평으로 
중심 에 놓이 도록 배 치한다. 15행 에 서 표식 자는 addMultiCellWidgetO 호출에 의해 2개 세 포에 
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배치된다. 처음 두 수는 행범위를, 두번째 두 수는 렬범위를 다음과 같이 지정한다 
startRow , endRow , startCol , endCol . 

17 〜 24 행 은 20개 항목을 가진 목록칸을 만들고 최 소너 비 를 120화소로 설 정한다. 24행 에 
서 addMultiCellWidget () 호출은 목록칸이 6개의 세포 즉 2><3세포를 차지하도록 한다. 

26〜29행은 오른쪽에 3개 단추를 만들고 매개를 한세포에 하나씩 배치한다. 그림 3-7 에 
보여준 결과는 9행에서 모든 세포들에 지정한것처럼 20화소간격으로 구분된 단추들을 현시 
한다. 


제6절. 수직칸배치 

QVBoxLayout 객체에 창문부품그룹을 삽입함으로써 수직렬에 창문부품그룹을 적당히 배 
치할수 있다. 처 음에 삽입 된 창문부품은 칸의 웃끝에 나타나고 2번째 창문부품은 그 아래 에 
배치되며 그 다음에 추가되는 창문부품은 목록의 제일 마지막 위치에 배치된다. 다음 실례 
는 수직 칸에 5개 단추를 공간과 가변성 을 조절하여 삽입한다. 

Main 

1 /* main.cpp */ 

2 #include < kapplication . h > 

3 #include " verticalbox . h n 

4 

5 int main(int argc , char ** argv ) 

6 { 

7 KApplication app ( argc , argv , " verticalbox "); 

8 VerticalBox *verticalbox = new VerticalBox (); 

9 verticalbox -> show (); 

10 app . setMainWidget ( verticalbox ); 

11 retum ( app . exec ()); 

12 } 

VerticalBox 객체 는 응용프로그람창문의 현시창문부품으로 사용된다. 

VerticalBox 머리 부파일 

1 /* verticalbox.h */ 

2 #ifndef VERTICALBOX_H 

3 #defme VERTICALBOX_H 

4 

5 #include < qwidget . h > 

6 #include < qlayout . h > 

7 #include < qpushbutton . h > 
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9 class VerticalBox : public QWidget 


[0 { 

il public : 


12 VerticalBox(QWidget * parent =0 ,const char * name =0); 

13 〜 VerticalBox (); 

14 private : 


5 

6 

7 

8 
9 


QPushButton 

QPushButton 

QPushButton 

QPushButton 

QPushButton 


* buttonOne ; 

* buttonTwo ; 

* buttonThree ; 

* buttonFour ; 

* buttonFive ; 


20 }; 


21 


22 #endif 
VerticalBox 

1 /* verticalbox.cpp */ 

2 #include M verticalbox . h M 

3 

4 VerticalBox : : VerticalBox(QWidget * parent,const char * name ) 

5 : QWidget ( parent , name ) 

6 { 

7 QVBoxLayout * layout = new QVBoxLayout ( this ,5); 

8 QSize buttonMaximum (400,400); 

9 

10 buttonOne = new QPushButton ( this ); 

11 buttonOne -> setText("BUTTON ONE "); 

12 buttonOne -> setMinimumSize ( buttonOne -> sizeHint ()); 

13 buttonOne -> setMaximumSize ( buttonMaximum ); 

14 layout -> addWidget ( buttonOne ); 

15 

16 buttonTwo = new QPushButton ( this ); 

17 buttonTwo -> se 付 ext (，’ BUTTON TWO "); 

18 buttonT wo -> setMinimumSize ( buttonTwo -> sizeHint ()); 
buttonTwo -> setMaximumSize ( buttonMaximum ); 


19 
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20 layout -> addWidget ( buttonTwo ,30); 

21 

22 layout -> addSpacing (20); 

23 

24 buttonThree = new QPushButton ( this ); 

25 buttonThree -> setText("BUTTON THREE "); 

26 buttonThree -> setMinimumSize ( buttonThree -> sizeHint ()); 

27 buttonThree -> setMaximumSize ( buttonMaximum ); 

28 layout -> addWidget ( buttonThree ); 

29 

30 layout -> addStretch (30); 

31 

32 buttonFour = new QPushButton ( this ); 

33 buttonFour -> setText("BUTTON FOUR "); 

34 buttonFour -> setMinimumSize ( buttonFour -> sizeHint ()); 

35 buttonFour -> setMaximumSize ( buttonMaximum ); 

36 layout -> addWidget ( buttonFour ); 

37 

3 8 layout -> addSpacing (5); 

3 9 layout -> addStretch ( 10); 

40 

41 buttonFive = new QPushButton ( this ); 

42 buttonFive -> setText( M BUTTON FIVE "); 

43 buttonFive -> setMinimumSize ( buttonFive -> sizeHint ()); 

44 buttonFive -> setMaximumSize ( buttonMaximum ); 

45 layout -> addWidget ( buttonFive ); 

46 

47 resize (10,10); 

48 layout -> activate (); 

49 } 

50 VerticalBox : : ~ VerticalBox () { } 

이 클라스는 7 행에서 만들어진 QVBoxLayout 객체에 기초하는 창문부품이다. 구성자의 
둘째 인수는 5화소경계선 이 포함된 모든 항목주위 에 삽입 되 도록 지 정한다. 이 경계선 이 0( 기 
정)으로 설정되면 포함된 항목들은 서로 린접에 놓인다. 

10〜14행은 하나의 단추를 만들고 그 본문과 최소크기를 설정하고 그것을 배치에 추가 
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한다. 그 최대크기를 어떤 큰 값으로 설정 하여 QVBoxLayout 객체를 적당히 늘일수 있다. 그 
것은 배치에 추가된 첫번째 단추이므로 제일 우에 나타난다. 

16〜20행은 둘째 단추를 만들고 배치에 추가한다. 그림 3-8 과 같이 첫째와 둘째 단추들 
사이의 거리는 10화소(단추1에서 5의 경계 + 단추1에서 5의 경계)이다. 그것들사이의 거리는 
배치가 늘어날 때도 변화되지 않는다. 20행에서 가변곁수 20은 단추가 칸에 추가될 때 지정 
되는데 이것은 배치크기가 변화할 때 단추자체가 가변되게 한다. 



I __ lOTTMONE" 


BUTTON IWO 


BUTTON THREE 
BUTTON FOUR 
BUTTON FIVE 




그림 3-8. 수직 으로 가변되 기전과 후의 수직 칸 

22행 은 단추2아래 에 20화소공간을 삽입한다. 그다음 24〜28행 에 서 단추3을 만들고 배 치 
에 추가된다. 이것은 단추2와 단추3사이가 항상 30화소 (2 개의 5화소경계 + 20화소공간)라는 
것 을 의 미한다. 

30행은 단추3 아래에 가변 곁 수 30을 가지는 가변 점을 추가하고 32〜36행은 그 아래에 
단추4를 삽입한다. 그림 3-8 과 같이 배치가 최소크기로 되였을 때 가변곁수에 의해 단추3과 
4사이에 어떤 공간도 추가되지 않는다. 그러나 창문이 수직으로 가변될 때 두 단추사이에 
공간이 나타난다. 38행 은 단추4아래 에 5화소공간과 가변곁 수10을 삽입한다. 그다음 41〜45행 
은 그 아래 에 단추5를 만들어 삽입한다. 이것은 두 단추사이 의 최소공간이 15화소 (2 개의 5화 
소경 계 +5화소공간)이 라는것 을 의 미한다. 

가변량은 모든 가변곁수들의 합과 매개 개별적 가변곁수의 비이다. 이 실례는 가변곁수 
30(20 행), 30(30 행) 그리 고 10(39 행)을 각각 지 정 한다. 가변 곁 수의 합은 70이 므로 창문크기 가 
바뀔 때 단추2는 변화의 3/7을 흡수하고 단추2와 3사이의 공간은 3/7을 흡수하며 단추4와 5 
사이의 공간은 1/7을 흡수한다. 

47행은 배치의 처음크기를 최소크기로 줄인다. 배치는 포함하고있는 모든 창문부품들과 
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공간의 최소크기를 합하여 최소크기를 결정한다. 48행은 부모창문이 현시될 때마다 배치가 
실현되도록 한다. 


제7절. 수평칸배치 

수평칸은 수직칸에서와 같지만 포함된 창문부품들이 우에서 아래로 놓이지 않고 왼쪽 
에서 오른쪽으로 나란히 놓인다. 그림 3-9 에 보여준 창문은 2가지 변경을 제외하고는 앞절에 
서 본 VerticalBox 창문부품과 등가한 HorizontalBox 창문부품에 의 해 만들어진다. 수평 칸의 구 
성자는 다음과 갈다. 

7 QHBoxLayout *layout = new QHBoxLayout ( this ,5 ); 

단추들의 이름은 창문이 그리 넓지 않으므로 짧아졌다. 그림 3-8 과 그림 3-9 를 비교하 
여보면 두 경우에 간격과 변화가 꼭 같다는것을 알수 있다. 


I ! BUTTON ONE ' 





그림 3-9 .수평 으로 신 축되 기 전 과 후의 수평칸 


제8절. 칸에서의 배치 

수직칸에 삽입된 창문부품크기는 수평으로 조절할수 없고 창문부품이 그것을 포함하는 
칸만큼 넓지 못하면 3가지 선택이 가능하다. 즉 창문부품은 왼쪽, 오른쪽, 또는 중심에 배치 
할수 있다. 다음 실례는 칸의 꼭대기에 긴 단추를 삽입하고 그 아래에 4개의 다른 고정크기 
단추를 삽입 함으로써 그림 3-10 과 갈은 창문을 생성한다. 



그림 3-10. 왼쪽, 오른쪽, 또는 중심 에 배치 한 고정크기창문부품 

Main 
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1 /* main.cpp */ 

2 #include < kapplication . h > 

3 #include " vboxalign . h " 

4 

5 int main(int argc , char ** argv ) 

6 { 

7 KApplication app ( argc , argv , ’’ vboxalign "); 

8 VBoxAlign *vboxalign = new VBoxAlign (); 

9 vboxalign -> show (); 

10 app . setMainWidget ( vboxalign ); 

11 retum ( app . exec ()); 

12 } 

VBoxAlign 머 리 부파 일 

1 /* vboxalign.h */ 

2 #ifiidef VBOXALIGN_H 

3 #defme VBOXALIGN_H 

4 

5 #include < qwidget . h > 

6 #include < qlayout . h > 

7 #include < qpushbutton . h > 

8 

9 class VBoxAlign : public QWidget 

10 { 

11 public : 

12 VBoxAlign(QWidget * parent =0 ,const char * name =0); 

13 〜 VBoxAlign (); 

14 private : 

15 QPushButton * acrossButton ; 

16 QPushButton * leftButton ; 

17 QPushButton * centerButton ; 

18 QPushButton * rightButton ; 

19 QPushButton * defaultButton ; 

20 }; 

21 


22 #endif 
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머 리 부파일은 클라스들이 창문을 완전히 가로지 르는 가변크기 단추와 일부분을 차지 하 
는 4 개의 고정크기단추들을 비공개성원으로 포함하도록 선언한다 . 

VBoxAlign 

1 /* vboxalign.cpp */ 

2 #include “vboxalign.h” 

3 

4 VBoxAlign: : VBoxAlign(QWidget ^parent,const char *name) 

5 : QWidget(parent,name) 

6 { 

7 QVBoxLayout *layout = new QVBoxLayout(this); 

8 

9 acrossButton = new QPushButton(this); 

10 acrossButton->setText( M All the way across’’); 

11 acrossButton->setMinimumSize(acrossButton->sizeHint()); 

12 layout->addWidget(acrossButton); 

13 

14 leftButton = new QPushButton(this); 

15 leftButton->setText("Left"); 

16 leftButton->setF ixedSize(leftButton->sizeHint()); 

17 layout->addWidget(leflButton,0,AlignLeft); 

18 

19 centerButton = new QPushButton(this); 

20 centerButton->setText( M Center M ); 

21 centerButton->setFixedSize(centerButton->sizeHint()); 

22 layout->addWidget(centerButton,0,AlignCenter); 

23 

24 rightButton = new QPushButton(this); 

25 rightButton->setText("Right n ); 

26 rightButton->setFixedSize(rightButton->sizeHint()); 

27 layout->addWidget(rightButton,0,AlignRight); 

28 

29 defaultButton = new QPushButton(this); 

30 defaultButton->setText("Default M ); 

31 defaultButton->setFixedSize(defaultButton->sizeHint()); 

32 layout->addWidget(defaultButton); 
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33 

34 resize(10,10); 

3 5 layout->activate(); 

36 } 

37 VBoxAlign: : ~VBoxAlign() { } 

9 〜 12 행은 오직 최소크기만 지정된 단추를 만들고 설치한다 . 또한 이 단추의 표식자는 
다른것들보다 길고 최소너비는 칸의 다른 단추들보다 크므로 이 단추는 칸자체의 최소너비 
를 결정한다 . 

14 〜 17 행은 항상 칸의 왼쪽에 놓이는 단추를 만들고 설치한다 . 16 행의 setFixedSize () 호출 
은 단추의 필 수크기 를 결 정 하고 최 소한계 와 최 대 한계 를 그 크기 로 설 정한다 . 17 행 의 
addWidget () 호출은 간격을 0( 기정)으로 설정하고 배치를 AlignLeft 로 지 정 한다 . 19 〜 22 행 에서 
다른 고정 크기 단추를 만들고 AlignCenter 배 치 로 칸에 추가한다 . 24 〜 27 행 에 서 만든 단추는 
AlignRight 로 설정된다 . 29 〜 32 행에서 정의된 마지막 단추에는 구체적인 배치설정을 주지 않 
았지 만 기 정 값을 AlignCenter 로 판명 된 다 . 

수평 칸은 수직 칸과 같은 방법 으로 동작하지 만 완전히 다른 배 치 방식이 름들을 가지 고있 
다 . 수직칸에 서 수평 으로 맞추는 창문부품들의 이 름들은 다음과 같다 . 

AlignLeft 

AlignCenter 

AlignRight 

마찬가지로 다음것은 수평칸에서 수직으로 배치하는 창문부품들의 3 가지 이름들이다 . 

AlignTop 

AlignCenter 

ALignBottom 


제9절. 배치안의 배치 

다음 실례는 어떤 배치를 다른 배치안에 포함하여 그림 3-11 에 현시된 창문을 생성하는 
방법을 보여 준다 . 부모배치는 2x2 크기의 QGridLayout 이다 . 그것은 왼쪽웃구석에 
QLCDNumber 창문부품， 2 개의 바닥세포를 차지하는 QSlider 창문부품을 포함한다 . 오른쪽아래 
구석의 세포는 QVBoxLayout 를 포함하고 그것은 또한 4 개 단추들을 포함한다 . 
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그림 3-11. QGridLayout 안에 놓인 QYBoxLayout 
알아두기 : QGridLayout 에 모든 창문부품들을 넣어서 대체로 어떠 한 배치도 엄을수 있 
으며 배치작업 을 이 와 같이 다시 나누는것 이 편리한 때가 있다 . 그룹에 의한 창문부 
품들의 취급은 복잡한 창문프로그람을 짜는 일을 간단화할수 있다 . 


1 /* main.cpp */ 

2 #include <kapplication.h> 

3 #include "layoutlayout.h" 

4 

5 int main(int argc, char **argv) 

6 { 

7 KApplication app(argc, argv, "layoutlayout ")； 

8 LayoutLayout *layoutlayout = new LayoutLayoutO ； 

9 layoutlayout->show(); 

10 app. setMain Widget(layoutlayout); 

11 retum(app. exec()); 

12 } 

LayoutLayoutO 리 부파일 

1 /* layoutlayout.h */ 

2 #ifndef LAYOUTLAYOUT_H 

3 #define LAYOUTLAYOUT_H 

4 

5 #include <qwidget.h> 

6 #include <qlayout.h> 

7 #include <qlcdnumber.h> 

8 #include <qpushbutton.h> 

9 #include <qslider.h> 
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10 

11 class LayoutLayout: public QWidget 

12 { 

13 public: 

14 LayoutLayout(QWidget *parent=0,const char *name=0); 

15 〜 LayoirtLayout() { }; 

16 private: 

17 QLCDNumber *lcd; 

18 QPushButton *openButton; 

19 QPushButton *saveButton; 

20 QPushButton *saveasButton; 

21 QPushButton *exitButton; 

22 QSlider *slider; 

23}; 

24 

25 #endif 

클라스선언은 현시해야 할 6 개 창문부품을 포함한다 . 그것들은 비록 다른 배치관리기들 
에 의해 배치되고 크기 가 조종된다 할지 라도 LayovrtLayout 창문부품클라스의 성원들이 다 . 2 개 
의 계층이 여기에 포함되지만 배치계층은 창문부품계층과 관계없다 . 배치계층은 아무일도 
하지 않지만 단지 자리표상에서 창문부품의 위치를 지정하고 크기를 계산한다 . 그러나 일부 
리 용에 서 매 개 창문부품(제 일 웃준위창문부품이 기 본창문에 사용되 는것 을 제 외 하고)은 창문 
부품나무에서 부모를 가져야 한다 . 

LayoutLayout 

1 /* layoutlayout.cpp */ 

2 #include ’’layoutlayout 上 ’’ 

3 

4 LayoutLayout: : LayoutLayout(QWidget *parent,const char *name) 

5 : QWidget(parent,name) 

6 { 

7 QGridLayout *layout = new QGridLayout(this,2,2,3 )； 

8 

9 led = new QLCDNumber(this); 

10 lcd->setNumDigits(2); 

11 lcd->display(43); 

12 lcd->setMinimumSize(100,100); 
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layout->addWidget(lcd,0,0); 


14 

15 QVBoxLayout *vertButtonLayout = new QVBoxLayout(3); 

16 layout->addLayout(vertButtonLayout,0,1); 

17 

18 openButton = new QPushButton("Open",this); 

19 openButton->setMinimumSize(openButton->sizeHint()); 

20 vertButtonLayout->addWidget(openButton); 

21 

22 saveButton = new QPushButton("Save M ,this); 

23 saveButton->setMinimumSize(saveButton->sizeHint()); 

24 vertButtonLayout->addWidget(saveButton); 

25 

26 saveasButton = new QPushButton("Save As., "’this); 

27 saveasButton->setMinimumSize(saveasButton->sizeHint()); 

28 vertButtonLayout->addWidget(saveasButton); 

29 

30 exitButton = new QPushButton("Exit M ,this); 

31 exitButton->setMinimumSize(exitButton->sizeHint()); 

32 vertButtonLayout->addWidget(exitButton); 

33 

34 slider = new QSlider(QSlider: : Horizontal,this); 

3 5 slider->setMinimumSize(slider->sizeHint()); 

36 layout->addMultiCellWidget(slider, 1,1,0,1); 

37 

38 resize(10 ， 10); 

3 9 layout->activate(); 

40} 

7 행에서 기본배치살창은 2x2 살창으로 만들어진다 . this 인수는 이것이 LayovrtLayout 객체의 
기 본배치객체 라는것을 지 정한다 . 또한 살창배치는 포함된 항목들 모두의 주위 에 3 화소공간 
을 삽입하도록 만들어진다 . 이 창문부품에 의해 현시하려는 모든 항목은 살창배치에 의해 
위치지 정되 여 야 한다 . (배치 에 그것들을 포함하지 않고 자식창문부품들을 현시 할수 있지만 
창문에서 그것들의 위치는 예측할수 없다 .) 

9 〜 13 행은 2 자리수 43 을 현시하도록 QLCDNumber 객체를 만들어 살창의 왼쪽웃구석에 
설치 한다 . 
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15 행 에서 수직배치칸이 만들어진다 . 수직칸은 기 본배치의 자식으로 포함되므로 지 정된 
부모가 없다 . 그리고 다음 행 (16 행)에서는 메쏘드 addLayout () 를 호출하여 수직칸을 살창배치 
의 오른쪽웃구석 항목으로서 삽입한다 . 

이것은 웃끝에 LayoutLayout 객체를 가지는 배치계층을 확립하며 7 행에서 QGridLayout 가 
다음 준위에 창조되고 15 행에서 QVBoxLayout 가 3 준위에 만들어진다 . 살창을 만드는데 인수 
this 를 사용하므로 그것을 제일웃준위용기로 설정한다 . this 인수는 수직칸을 만드는데 쓰이지 
않으므로 addLayoutO 호출이 이 루어 져 그 계 층을 확립한다 . 

알아두기 : QLayout 객체는 추가된 자식 창문부품 또는 배치를 가지기전에 부모를 가지 
고있어야 한다 . 기본배치는 둘러싸고있는 창문부품의 자식이여야 하며 기타 다른 모 
든 배치들은 기본배치의 자식(또는 자손)이여야 한다 . 

18 〜 20 행은 QPushButton 을 창조하여 수직칸에 추가한다 . 단추들에 최소크기가 설정되지 
만 최대값은 없으므로 단추는 칸이 다 차도록 확장된다 . 22 〜 32 행은 3 개이상의 단추를 만들 
어 칸에 추가한다 . 그 결과 처음에 그림 3-11 의 오른쪽웃구석에 보여주는 단추들의 렬이 생 
긴 다 . 

34 〜 36 행은 QSlider 를 만들어서 2 개 바닥세 포를 차지 하도록 살창배치 에 추가한다 . 단추 
들과 같이 최소크기를 할당하지만 살창배치의 세포들을 채우도록 확장할수 있다 . 

38 행 에서 resize 。 호출은 생성된 창문부품의 처음크기가 최소값이라는것을 담보한다 . 최 
소크기 는 LayoirtLayout 창문부품이 QGridLayout 에 요구하여 결정한다 . QGridLayout 는 
QLCDNumber, QSlider 그리 고 QVBoxLayout 의 최 소크기 에 경 계 선간격 을 합하여 그 자체 의 최 
소크기 를 엄는다 . QVBoxLayout 는 매 단추들의 최 소크기 를 엄고 자기 의 최 소크기 를 결정한 
다음 최 대 수평값과 수직 값합계 를 자기 의 최 소너 비 와 최 소높이 로 사용한다 . 

요 약 

창문부품들의 크기와 위치를 지정하는 여러가지 방법이 있다 . 어떤 방법은 자동적으로 
창문부품들의 크기를 변경하며 또 어떤 방법은 변경하지 않는다 . 마찬가지로 어떤 방법은 
창문부품들이 겹치게 하지만 다른 방법은 겹치게 하지 않는다 . 자기 응용프로그람에 가장 
좋은 방법을 적용하려면 모든 방법을 알고있어야 한다 . 

• x 와 y 자리표는 높이와 너비에 따라서 창문부품의 위치와 크기를 고착시키는데 사용될 
수 있다 . 

• 가상살창은 기본창문으로 설치될수 있고 창문부품들은 살창에 배치할수 있다 . 

• 창문부품은 창문에서의 배치에 적합하게 그 크기와 모양을 바꿀수 있다 . 이 변화는 
창문부품의 최대크기와 최소크기설정에 의해 제한된다 . 

• 수평 칸과 수직 칸들은 일직 선 에 놓인 창문부품들의 행과 렬들을 현시한다 . 매개 창문 
부품들사이에 간격과 위치를 조종할수 있다 . 

- 수평배치 와 수직배치 들은 직 선상에 놓인 창문부품들의 행과 렬들을 현시한다 . 또한 
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배치는 그 자체가 창문부품이므로 다른 배치，칸 , 또는 살창을 포함하거 나 지 어는 특정한 X 
와 y 자리표에 의해 배 치 될 수도 있다 . 

이 장은 제 일 웃준위창문을 만드는 방법 을 설 명하였 다 . 다음 장은 튀 여나오기창문을 만 
드는 방법을 설명한다 . 제일 웃준위창문용 창문부품들의 위치를 지정하는 모든 도구와 방법 
은 튀여나오기창문안에 있는 창문부품들의 위치지정에도 사용된다 . 기본차이는 대화칸이 사 
용자에 게 정 보를 현시 하고 몇 가지 종류의 응답을 돌려주는데 사용되 는 일시창문이라는것 이 
다 . 
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제 4 장. 튀여나오기대화칸의 현시 

학습내용 

간단한 대화칸의 창조와 현시 

대화칸으로부터 신호를 받아들이는 처리부의 실현 

대화칸에서 처리부들에 전송할 신호의 창조 

사용자정의대화칸 만들기 

KDialogBase 의 확장 

KMessageBox 에 정의된 일반대화칸의 펼치기 

대 화칸은 보통 일시 적 인 창문으로서 사용자에 게 특정한 정 보를 현시 하고 사용자로부터 
특정한 정보를 요구한다. 많은 대화칸은 매우 간단하고 오직 예 또는 아니라는 대답만 요구 
하지만 매우 복잡한 대화칸은 흔하지 않고 정보를 현시하고 받아들이는 창문부품들의 여러 
폐지를 포함한다. 

대 화칸은 응용프로그람창문을 부모로 하지 만 항상 독립창문으로 현시 기 에 나타난다. 그 
것은 일부 창문조종과 차림표가 없는것을 제외하면 제일 웃준위창문과 거의 갈아보인다. 

확장가능한 대화칸기초클라스가 많으므로 프로그람이 대화칸을 만드는 방법도 많다. 또 
한 기초클라스자체는 상대적으로 간단한 대화칸을 만드는데 사용될수 있다. 이 장은 제각기 
자기의 우점을 가지고있는 기초클라스들로부터 대화칸을 만드는 여러가지 방법을 실례를 들 
어 설명한다. 


제1절. 간단한 대화칸 

QDialog 창문부품은 대화칸을 만드는데 사용할수 있는 기초클라스이지만 또한 간단한 
창문부품들의 배치를 조종하는데 직접 사용될수 있다. QDialog 는 빈 창문만 현시하는 간단한 
창문부품이 지 만 창문부품들의 용기 로서 사용될수 있고 독립창문에 그것을 현시할 능력 을 가 
지고있다. 또한 창문에 단추들을 추가하여 거기 에 응답하기 위한 기 본기능들이 있다. 

다음 실례는 대화칸을 만들고 현시하는 방법을 보여준다. 그것은 QDialog 객체를 대화칸 
으로 현시 하는 방법 을 보여준다. 그림 4-1 의 왼쪽그림 이 제 일 웃준위창문이 다. 그것은 오른 
쪽에 있는 대화칸을 펼치는데 사용되는 하나의 단추를 포함한다. 대화칸에는 그것을 완료하 
는데 사용할수 있는 단추가 있다. 



그림 4-1. 제일 웃준위창문과 그것이 펼치는 대화칸 
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1 /* simple.cpp */ 

2 #include < kapplication . h > 

3 #include " toplevel . h ” 

4 

5 int main(int argc , char ** argv ) 

6 { 

7 KApplication app ( argc , argv , " simple "); 

8 TopLevel toplevel ; 

9 toplevel . show (); 

10 app . setMainWidget (& toplevel ); 

11 retum ( app . exec ()); 

12 } 

프로그람의 기본함수는 KApplication 객체를 만들고 TopLevel 창문부품을 그 제일 웃준위 
창문으로 만들고 설 치한다. 

TopLevel 머 리 부파일 

1 /* topleveLh */ 

2 #ifndef TOPLEVEL_H 

3 #defme TOPLEVEL_H 

4 

5 #include < qwidget . h > 

6 

7 class TopLevel : public QWidget 

8 { 

9 Q_OBJECT 

10 public : 

11 TopLevel(QWidget * parent =0 ,const char * name =0); 

12 private slots : 

13 void popupDialog (); 

14}； 

15 

16 #endif 

TopLevel 창문은 QWidget 를 계 승하므로 창문부품이 며 프로그람의 제 일 웃준위 창문용으 
로 설계된다. 클라스선언은 오직 구성자와 단추에 응답하는데 필요한 최소량의 정보를 포함 
한다.9행의 Q_OBJECT 마크로는 12행과 13행에서 선언한 처리부를 위해 제시되여야 한다. 처 




리부메쏘드 popupDialog() 는 단추를 누를 때마다 호출된다 . 

TopLevel 

1 /* toplevel.cpp */ 

2 #include "toplevel.h” 

3 #include <qdialog.h> 

4 #include <qpushbutton.h> 

5 

6 TopLevel: : TopLevel(QWidget *parent,const char *name) 

7 : QWidget(parent,name) 

8{ 

9 setMinimumSize(200,80); 

10 setMaximumSize(200,80); 

11 

12 QPushButton ^button = new QPushButton("Pop Up”,this); 

13 button->setGeometry(50,20,100,40); 

14 connect(button,SIGNAL(clicked()), 

15 this,SLOT(popupDialog())); 

16} 

17 void TopLevel::popupDialog() 

18 { 

19 QDialog ^dialog = new QDialog(0, "popup",FALSE); 

20 dialog->setCaption("A QDialog Window"); 

21 dialog->setMinimumSize(200,80); 

22 dialog->setMaximumSize(200,80); 

23 

24 QPushButton ^button = 

25 new QPushButton("Pop Down",dialog); 

26 button->setGeometry(50,20,100,40); 

27 connect(button,SIGNAL(clicked()), 

28 dialog,SLOT(accept())); 

29 

30 dialog->show(); 

31} 

이 코드는 대화칸을 만들고 현시하는 메쏘드를 비롯한 TopLevel 창문부품의 정의를 포 
함한다 . 
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TopLevel 창문부품은 프로그람의 기 본창문이 다. 9,10행의 구성 자에서 창문크기 를 변경 할 
수 없게 설정되였으며 최대크기와 최소크기는 같은 값으로 설정된다. 12행에서 단추가 만들 
어진다. 13행의 기하학적크기설정은 단추의 높이와 너비 그리고 그 왼쪽웃구석의 위치를 지 
정 한다. 14행 에 서 connectO 호출은 단추의 clickedf ) 신호로부터 발생 하는 사건들이 TopLevel 창 
문부품의 popupDialog () 로 넘 어간다는것 을 의 미한다. 

17행의 메쏘드 popupDialogO 는 TopLevel 창문에서 사용자가 단추를 찰칵할 때마다 호출 
된다. 19〜22행 은 QDialog 창문부품의 실례 를 만들고 그 크기와 제목을 지 정 한다. 24〜26행 에 
서 창문부품이 보관하려 는 단추를 만들고 크기 를 지 정한다. 27행 에서 connectO 호출은 단추의 
clicked () 로부터 발생 하는 신 호가 QDialog 창문부품 안의 accept () 메 쏘드로 넘 어 가도록 한다. 30 
행에서 showO 호출은 QDialog 창문부품이 자기 창문에 현시되게 한다. 

QDialog 창문부품은 사용자가 그것을 리용하여 모든 대화칸을 창조할수 있도록 충분히 
유연하다. 이 실례에서처럼 처리부메쏘드 accept () 에 의해 대화칸을 닫을수 있고 또한 reject () 
를 호출하여 대화칸을 닫을수 있다. 두 메쏘드들사이의 유일한 차이는 그것들중 하나가 결 
과를 TRUE 로 설정하고 다른것은 FALSE 로 설정하는것이다. 이 설정값은 일반적으로 대화칸 
에 나타나는 Cancel 과 OK 단추에 대응된다. 

대화칸이 accept () 혹은 reject 호출에 의하여 닫길 때 그것은 파괴되지 않는다. 그 창문 
은 hide 。 메쏘드호출에 의해서 닫긴다. 이것은 프로그람이 설정값을 읽을수 있는 우점을 가지 
고 있으나 자체로 대화칸을 제거해야 한다. 그러나 같은 대화칸을 반복 사용하려면 그것을 
일단 만들고 필요할 때 hide () 와 show(j 호출할수 있다. 

이 실례는 2가지 문제점이 있다. 첫째로, 요구되는만큼 대화칸을 많이 펼칠수 있다. 즉 
Pop Up 단추를 찰칵할 때마다 새로운 대화칸이 생겨나고 실행된다. 둘째로, Push Down 단추로 
대 화칸을 닫을 때 그것 은 삭제되 지 않는다. 그것 은 accept () 호출에 의해 닫기 지 만 여 전히 존 
재하며 프로그람은 그 지적자를 가지지 않는다. 

알아두기: 창문제목을 설정하고 크기와 여백을 변경하는 메쏘드들이 추가된것외에 
QDialog 창문부품과 거의 같은 KDialog 창문부품이 있다. QDialog 을 사용할수 있는곳에 
서는 어디서나 KDialog 를 사용할수 있다. 


제2절. 신호와 처리부의 사용 

이 실례는 QDialog 를 기초클라스로 사용하여 문자렬을 받아들이는 대화칸을 만든다. 그 
리고 OK 또는 Apply 단추가 선택되면 문자렬은 프로그람의 기본창문에 전송되고 제목띠를 
새로운 표제로 설치한다. 그림 4-2 의 왼쪽창문은 기 본창문과 그 한개 단추를 보여 준다. 오른 
쪽에는 새 제목문자렬을 받아들이고 표시하는 대화칸이다. 
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그림 4-2. 단추와 그것이 펼치는 대화칸 


Mainline 


1 /* responder.cpp */ 

2 #include < kapplication . h > 

3 #include ’’ mainwidget 上’’ 

4 


5 int main(int argc , char ** argv ) 

6 { 

7 KApplication app ( argc , argv , " responder "); 

8 MainWidget mainwidget ; 

9 mainwidget . show (); 

10 app . setMainWidget (& mainwidget ); 

11 retum ( app . exec ()); 

12 } 

프로그람의 기본함수는 아주 간단하다. 8행과 9행 에서 MainWidget 객체를 만들고 10행은 
그것을 기본창문으로 설치한다. 

MainWidget 머 리 부과 일 

1 /* mainwidget.h */ 

2 #ifndef MAINWIDGET_H 

3 #define MAINWIDGET_H 

4 


5 #include < qwidget . h > 

6 #include < qstring . h > 

7 

8 class MainWidget : public QWidget 

9{ 

10 Q_OBJECT 

11 public : 

12 MainWidget(QWidget * parent =0 ,const char * name =0); 

13 private slots : 
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14 void popupEnterName(); 

15 void changeCaption(QString &); 

16 }； 

17 

18 #endif 

이 실례 에서 기 본창문으로 작용하는 창문부품의 머 리 부파일 이다 . 이 클라스는 12 행 에서 
선언된 구성자외에 두개의 처리부를 포함한다 . popupEnterName() 처리부는 대화칸을 펼치고 
changeCaptionO 처 리 부는 이 창문부품의 제 목(기 본창문의 제 목)본문을 변 경한다 . 

이 클라스에 처리부들이 있으므로 클라스의 첫 성원으로서 Q_OBJECT 마크로를 사용한 
다 . Q_OBJECT 안의 정의들은 이 머리부파일을 표준 C++ 코드로 콤파일하게 하며 그것은 처리 
부와 신호를 조종하는데 필요한 코드를 생성하기 위하여 메타객체콤파일러 (Meta Object 
Compiler, MOC) 에 서 사용하는 특별 한 정 보를 삽입한다 . 

MainWidget 

1 /* mainwidget.cpp */ 

2 #include "mainwidget.h" 

3 #include "entemame.h" 

4 #include <qpushbutton.h> 

5 

6 MainWidget: : MainWidget(QWidget ^parent,const char *name) 

7 : QWidget(parent,name) 

8{ 

9 setMinimumSize(200,80); 

10 setMaximumSize(200,80); 

11 

12 QPushButton ^button = 

13 new QPushButton("Update Name",this); 

14 button->setGeometry(50,20,100,40); 

15 connect(button,SIGNAL(clicked()), 

16 this,SLOT(popupEnterName())); 

17} 

18 void MainWidget: : popupEnterName() 

19 { 

20 EnterName * dialog = new EnterName(0, ’’entemame"); 

21 connect(dialog,SIGNAL(captionString(QString &)), 

22 this,SLOT(changeCaption(QString &))); 
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23 dialog->exec(); 

24 delete dialog; 

25} 

26 void MainWidget: : changeCaption(QString &caption) 

27 { 

28 setCaption(caption); 

29} 

이 클라스는 응용프로그람의 기본창문으로 사용된다 . 그것은 이 절의 앞에서 보여준 그 
림 4-2 의 왼쪽에 창문으로 현시된다 . 

이 클라스는 7 행에서 QWidget 를 계승하므로 창문부품이다 . 9 행과 10 행은 최대크기와 최 
소크기를 같은 값으로 설정하여 이것을 고정크기창문부품으로 만든다 . 

QPushButton 은 12 행과 13 행에서 창조되고 14 행에서 창문중심에 배치된다 . 단추는 마우 
스에 눌러울 때마다 발생하는 clicked() 라는 신호를 가지고있다 . 15 행의 connect() 호출은 
clicked() 신 호가 발생 할 때 마다 국부처 리 부메 쏘드 popupEnterName() 가 호출되 도록 설 정 한다 . 
알아두기 : 메쏘드를 처리부로 리용하여도 그것을 직접 호출할수 있다 . 이 실례에서 
메 쏘드 popupEnterName() 는 신호에 의해 호출되 지 만 이 클라스의 다른 메 쏘드로부터 
지어 다른 클라스로부터도 호출될수 있다 . 처리부는 신호를 포착하는데 사용할수 
있는 추가특성을 가지는 보통 메쏘드이다 . 

18 행의 메쏘드 popupEnterName() 는 EnterName 대화칸을 만들고 사용자에게 새로운 제목 
을 묻는다 . 21 행에서 connect() 호출은 대화칸에서 captionS 仕 ing() 신호가 changeCaption() 국부처 리 
부호출을 만들도록 련결한다 . 

23 행의 execO 호출은 대화칸을 펼치고 대화칸은 입 력대 기렬 에로의 호출을 독점한다 . 이 
메쏘드는 사용자가 OK 또는 Cancel 단추를 선택하여 응답할 때까지 되돌아가지 않는다 . 사용 
자가 응답할 때까지 이 응용프로그람이 소유한 다른 창문은 마우스 또는 건반신호들을 받지 
않는다 . 23 행 에서 응답이 이 루어 진 후에 대 화칸이 삭제 된다 . 

26 행의 처리부메쏘드는 오직 사용자가 대화칸에서 OK 단추를 선택할 때만 호출되므로 
새 로운 제 목문자렬 이 기 본창문용으로 설 정 된다 . 

EnterName 머 리 부파 일 

1 /* entemame.h */ 


2 #ifndef ENTERNAME_H 

3 #define ENTERNAME_H 

4 

5 #include <qdialog.h> 

6 #include <qlineedit.h> 

7 #include <qpushbutton.h> 
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9 class EnterName: public QDialog 

10 { 

11 Q_OBJECT 

12 private: 

13 QLineEdit *lineedit; 

14 QPushButton *okButton; 

15 QPushButton *applyButton; 

16 QPushButton *cancelButton; 

17 public: 

18 EnterName(QWidget *parent=0,const char *name=0); 

19 private slots: 

20 void okButtonSlot(); 

21 void applyButtonSlot(); 

22 void cancelButtonSlot(); 

23 signals: 

24 void captionString(QString &); 

25}; 

26 

27 #endif 

이 머 리부파일은 새 제목문자렬을 묻는데 사용되는 튀 여 나오기대화칸의 클라스를 선 언한다 . 
그것은 단추찰칵을 받아들이는 처 리부들과 새 제목본문과 함께 보내는 신호를 가지고있다 . 

이 클라스는 9 행에서 기초클라스로서 QDialog 를 사용하므로 대화칸선언이다 . 처리부나 신 
호를 포함하는 클라스는 반드시 첫 성원으로서 Q_OBJECT 마크로를 포함하여 야 한다 . D 〜 16 행은 
대화칸의 성원들을 구축하는데 사용할 4 개 창문부품용 기 억공간을 선 언한다 . 

19 〜 22 행 은 처 리 부들의 이 름을 지 정 한다 . okButtonSlot(), applyButtonSlot() 및 
cancelButtonSlotO 메 쏘드들은 단추찰칵을 받아들이 기 위 한 국부처 리 부들이 다 . 24 행의 신호 
captionStringO 은 사용자가 새 제목문자렬을 내보낼 때마다 발생되는 신호이다 . 

EnterName 

1 /* entemame.cpp */ 

2 #include "entemame.h" 

3 #include <qdialog.h> 

4 #include <qlayout.h> 

5 


6 EnterName: : EnterName(QWidget ^parent,const char *name) 



7 : QDialog(parent,name,TRUE) 

8 { 

9 QString caption( M Enter Name"); 

10 setCaption(caption); 

11 

12 QVBoxLayout *vLayout = new QVBoxLayout(this, 10); 

13 

14 lineedit = new QLineEdit(this); 

15 vLayout->addW idget(lineedit); 

16 

17 QHBoxLayout *hLayout = new QHBoxLayout(vLayout, 10); 

18 

19 okButton = new QPushButton("OK M ,this); 

20 connect(okButton,SIGNAL(clicked()), 

21 this,SLOT(okButtonSlot())); 

22 hLayout->addWidget(okButton); 

23 

24 applyButton = new QPushButton("Apply",this); 

25 connect(applyButton,SIGNAL(clicked()), 

26 this,SLOT (applyButtonSlot())); 

27 hLayout->addW idget(applyButton); 

28 

29 cancelButton = new QPusMutton("Cancel’’,this); 

30 connect(cancelButton,SIGNAL(clicked()), 

31 this,SLOT(cancelButtonSlot())); 

32 hLayout->addWidget(cancelButton); 

33} 

34 void EnterName: :okButtonSlot() 

35 { 

36 QString str = lineedit->text(); 

37 emit captionS tring(str); 

38 accept(); 

39} 

40 void EnterName :: applyButtonSlot() 

41 { 


68 




42 QString str = lineedit->text(); 

43 emit captionS tring(str); 

44} 

45 void EnterName::cancelButtonSlot() 

46 { 

47 reject(); 

48} 

이 클라스는 사용자가 본문을 입력하고 적당한 단추를 선택함으로써 본문이 기본창문 
의 제목으로 설치되게 하는 대화칸이다 . 

6 행 에 서 EnterName 구성 자에 로의 인수가 7 행 에 서 QDialog 기 초클라스에 로 넘 어 간다 . 

QDialog 의 셋째 인수는 TRUE 이고 이것 이 이 행금지대화칸이라는것을 지정한다 . 

12 행에서 창조한 수직칸은 창문을 위한 기본용기로 사용된다 . 14 행에서 창조한 QLineEdit 객 
체는 수직칸의 꼭대기에 삽입된다 . 수평칸은 수직칸의 자식으로 만들어지는데 그것은 수평칸이 
수직칸災 LineBdit 창문부품의 바로 아래)의 다음 성원이 되게 한다 . 수평칸에 3 개 단추를 삽입하 
여 (22, 27 그리고 32 행 ) 이전에 그림 4-2 에서 오른쪽에 보여준 배치를 완성한다 . 

20, 25 그리고 30 행에서 connectO 메쏘드호출은 단추들의 clicked () 신호를 매개 처리 부에 
련결 한다 . 

34 행의 처 리부메쏘드 okButtonSlotO 는 OK 단추를 찰칵할 때마다 호출된다 . QLineEdit 객체 
의 text 。 호출은 사용자가 입력한 문자렬을 받아들인다 . 37 행은 captionStringO 이라는 신호를 
발생한다 . 신호는 메쏘드를 호출하는데 사용하는것과 거의 갈은 문법으로 발생되지만 그것 
이 메쏘드가 아니라 내보내는 신호라는것을 의미하는 예약어 emit 를 앞에 붙인다 . 처리부메 
쏘드는 38 행에서 accept 를 호출함으로써 완료한다 . 이 호출은 내부기발을 TRUE 로 설정하여 
사용자로부터 긍정적인 응답이 있다는것을 지적하고 hideO 를 호출하여 창문부품을 보이지 
않게 한다 . 

Apply 단추를 찰칵할 때마다 40 행의 applyButtonSlot() 가 호출된다 . OK 단추처리부로 수행 
한것 처 럼 신 호메 쏘드 captionStringO 을 사용하여 문자렬 을 얻 고 신 호를 발생 시킨 다 . accept() 메 
쏘드는 대 화칸이 보임 상태 로 되 여있으므로 호출되 지 않는다 . 

Cancel 단추를 찰칵할 때마다 45 행의 cancelButtonSlotO 가 호출된다 . 사용자가 제목이름을 
변경하는 작용을 취소하였으므로 어떤 신호도 발생하지 않는다 . reject 호출이 이루어지고 내 
부기발이 FALSE 로 설정되고 대화칸의 창문이 닫긴다 . 


Makefile 

1 INCL= -I$(QTDIR)/include -I$(KDEDIR)/include 

2 CFLAGS= -02 -fiio-strength-reduce 

3 LFLAGS= -L$(QTDIR)/lib -L$(KDEDIR)/lib -L/usr/XllR6/lib 

4 LIBS= -lkdecore -lkdeui -lqt -1X11 -lXext -ldl 
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5 CC=g++ 


7 recaption: recaption.o mainwidget.o moc mainwidget.o \ 

8 entemame.o moc_entemame.o 

9 $(CC) $(LFLAGS) -o recaption recaption.o \ 

10 mainwidget.o moc mainwidget.o \ 

11 entemame.o moc_entemame.o $(LIBS) 

12 

13 recaption.o: recaption.cpp mainwidget.h 

14 mainwidget.o: mainwidget.cpp mainwidget.h 

15 moc mainwidget.cpp : mainwidget.h 

16 $(QTDIR)/bin/moc mainwidget.h -o moc mainwidget. cpp 

17 entemame.o: entemame.cpp entemame.h 

18 moc entemame.cpp : entemame.h 

19 $(QTDIR)/bin/moc entemame.h -o moc entemame.cpp 

20 

21 clean: 

22 rm -f recaption 

23 rm-f *.o 


24 rm -f moc_* 

25 

26 .SUFFIXES: .cpp 

27 

28 .cpp.o: 

29 $(CC) -c $(CFLAGS) $(INCL) -o $@ $< 

이 코드가 설명하는것처럼 처리부 또는 신호가 원천에 포함될 때 특별한 항목들이 
makefile 에 포함되 여 야 한다 . 코드는 직 접 콤파일될뿐아니 라 또한 MOC 콤파일러 에 의 해 콤파 
일될 독립적인 원천파일로 변환된다 . 

7 행에는 recaption 을 련결하는 의존관계목록가 있다 . 거기에는 .cpp 파일들의 이름과 일치 
하는 .o 파일들뿐아니라 4 개 기호 1 미피_로 시작하는 .o 파일들도 있다 . 첫 성원으로 Q_OBJECT 
를 포함하는 클라스(처 리부 또는 신호를 가지는 클라스 ) 는 MOC 콤파일러 에 의해 처 리된 머 
리부파일을 가지고 있어야 한다 . 15 행의 의존관계는 원천파일 moc_mainwidget.cpp 가 원천파일 
mainwidget.h 에 의존하도록 설정한다 . 16 행의 지령은 입력으로서 mainwidget.h 를 사용하여 
moc_mainwidget.cpp 를 만든다 . 그 다음에 moc_mainwidget.cpp 는 moc_mainwidget.o 로 를파일되 
여 9 행에서 련결에 포함된다 . 
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제 3 절. 신호와 처리부검사목록 

신호와 처 리 부는 아주 간단히 만들수 있다 . 대 부분의 작업 은 마크로와 MOC 콤파일 러형 
식으로 자동화된다 . 신호를 발송하는 과정은 처리부가 신호를 받아들이는 과정과 완전히 독 
립된다 . 객체는 신호를 받아들이는 처리부들이 얼마인지 모르고도 임의의 개수의 신호를 낼 
수 있다 . 다음에 신호를 만들어서 처리부들에 보내기 위하여 수행해야 할 모든 단계를 포함 
한다 . 

① 클라스선언의 첫 행으로서 Q_OBJECT 마크로를 추가한다 . 클라스의 다른 항목들은 
반두점으로 끝나야 하지만 Q_OBJECT 마크로는 그렇지 않다 . 그러나 만일 좋아한다면(콤파일 
러 가 간단히 반두점 을 버리 므로 ) 포함할수 있다 . 실례로 Receiver 라는 클라스의 선 언은 이 방 
법으로 시작한다 . 

class Sender { 

Q-OBJECT 


임의의 개수의 처 리부와 신호를 객체 에서 정의할수 있으나 Q_OBJECT 마크로는 오직 
한번 포함해야 한다 . 

② 클라스선언에 신호의 원형을 추가한다 . 실례로 신호가 인수로서 문자렬객체를 보내 
려고 한다면 원형은 다음과 같다 . 

signals: 

void newName(QString &name); 


실제 메쏘드는 없으므로 공개 나 비 공개지정 도 없다 . 이 것은 받아들이 는 처 리 부를 호출 
하는데 쓰이는 원형의 선언이다 . 

③ emit 명령문을 사용하여 신호를 받아들이는 모든 처리부메쏘드를 호출한다 . 이것은 
emit 예약어가 호출앞에 놓이는것을 제외하면 국부메쏘드호출과 갈은 문법으로 수행된다 . 

QS 仕 ing name; 
emit newName(name); 

신 호메 쏘드본체 의 실제 정 의 는 없다 . emit 지 령 은 국부메 쏘드를 찾지 않고 그대 신 에 이 신 
호에 련결되 여있는 처 리부목록안의 모든 처 리부메쏘드를 호출한다 . 

다음 단계는 처리부를 만들어서 신호에 련결하는데 필요하다 . 

① 신호에서와 같이 처리부는 QJDBJECT 마크로를 클라스선언의 선두에 포함해야한다 . 
class Receiver { 

Q_OBJECT 
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② 클라스선언에 처리부메쏘드들의 원형을 추가한다. 원형은 그것이 받아들일 신호와 
갈아야 한다. 즉 갈은 인수모임을 가져야 한다. 처리부는 메쏘드이고 처리부로 사용될뿐아니 
라 직접 호출될수 있으므로 처리부메쏘드를 공개적으로 사용할수 있다. 

public slots : 

void nameChange(QString & name ); 

오직 신호들을 받아들일 목적으로 사용되는 처리부는 비공개로 선언한다. 

③ 신호를 발생시키는 클라스를 선언하는 머리부파일을 포함한다. 

④ 그 신호를 발생시키는 클라스의 실례를 창조하는 코드를 쓴다. 그것은 신호에 처리 
부를 련결하기 위하여 필요하다. 

⑤ 신호에 처리부를 련결한다. 이것은 흔히 구성자에서 수행되지만 객체가 후에 만들어 
지 면 후에 수행 될 수 있다. connectO 메 쏘드호출은 특정 한 신 호가 발생 될 때 마다 호출되 는 메 
쏘드들의 목록에 처 리 부를 추가한다. connectO 호출은 다음과 갈다. 

connect ( sender , SIGNAL ( newName(QString &), this , SLOT ( nameChange(QString &))); 

처 음 2 개 인수는 신호의 원천을 지 정 하고 두번째 2개는 목적 처 리 부를 지 정한다. 마크로 
SIGNAL 。 과 SmT () 는 모두 완전한 메쏘드원형을 요구하며 원형은 두 메쏘드들의 인수모임 
은 서로 같아야 한다. 

emit 문이 신호를 보낼 때 마치도 자기 프로그람이 직접 처리부메쏘드중 하나를 호줄한 
것처럼 정확하다. 즉 프로그람은 처리부메쏘드가 되돌아갈 때까지 계속할수 없다. 그러므로 
보통 신호발생기가 정지하지 않도록 처리부메쏘드내에서의 처리를 될수록 간단하게 해야 한 
다. 신호의 발생기는 사용자대면부프로쎄스일수 있고 느리거나 완만한 조작을 출현시킬수 
있다. 

순환이 일어 나지 않도록 매우 주의해 야 한다. 처 리부메쏘드가 직 접 이든 간접 이든 원천 
의 처 리 부에 의 해 받아들인 신호를 발생시키 는 메쏘드를 실행하면 신호들은 계속 처 리부들 
을 호출하며 프로그람은 중단된다. 실례로 first () 라는 메쏘드가 신호 A 를 발생시키고 신호 A 
를 secondO 처리부가 받아들이고 처리부 secondO 는 신호 B 를 발생시키고 first 。 처리부는 신 
호 B 를 받아들이면 순환이 존재하고 그것은 프로그람이 중단할 때까지(사용자가 기다리기 
실증날 때까지) 계속된다. 

또한 connect 문의 처리 부와 신호메쏘드들이 일치 하는 인수를 가지지 않으면 프로그람이 
실행되고 있을 때 참고를 해결하려는 시도가 이루어질 때까지 오유통보문을 엄지 못한다. 

이것을 피하기 위하여 처리부와 신호에 만드는 모든 추가 혹은 변경을 정확히 검사하 
여야 한다. 유일한 오유통보문은 connectO 메쏘드가 쌍을 찾는데 실폐하고 그후에 프로그람이 
조용히 신 호들을 무시할 때 표준말단(표준출력 )에 써 내 보내 는 문자별 이 다. 그리 고 오직 지 령 
행으로부터 응용프로그람을 실행할 때 콘솔출력을 볼수 있다. 


72 



제 4 절. KDialogBase 


창문부품 KDialogBase 는 대화칸의 한 종류이다 . 대부분의 대화칸은 같은 기본형식 즉 
바닥에 단추들의 행을 가지는 자료항목창문부품들의 집합이다 . 그와 함께 KDialogBase 창문부 
품은 단추들의 기본 ( 짜넣은)행으로 설계되였다 . 다음 실례프로그람은 그림 4-3 과 같이 
KDialogBase 의 기정환경구성을 보여준다 . 



그림 4-3. KDialogBase 창문의 기 정 단추 

Mainline 

1 /* kdbsimple.cpp */ 

2 #include <kapplication.h> 

3 #include "mainwidget 上 ’’ 

4 

5 int main(int argc, char **argv) 

6 { 

7 KApplication app(argc, argv, ’’kdbsimple’’); 

8 MainWidget mainwidget; 

9 mainwidget.show(); 

10 app. setMain Widget(&mainwidget); 

11 retum(app. exec()); 

12 } 

8 행에서 만들어진 mainwidget 는 10 행에서 응용프로그람의 기본창문으로 설정된다 . 
MainWidget 머 리 부과 일 

1 /* mainwidget.h */ 

2 #ifndef MAINWIDGET_H 

3 #define MAINWIDGET_H 

4 

5 #include <qwidget.h> 

6 

7 class MainWidget: public QWidget 

8 { 

9 Q_OBJECT 
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10 public: 

11 MainWidget(QWidget *parent=0,const char *name=0); 

12 private slots: 

13 void popupKdb(); 

14 }； 

15 

16 #endif 

기본창문은 오직 2 개의 메쏘드를 가지고있다 . 하나는 구성자이고 다른것은 누름단추에 
련 결 될 처 리 부이 다 . popupKdb () 의 목적 은 KDialogBase 창문을 현 시 하는것 이 다 . 

MainWidget 

1 /* mainwidget.cpp */ 

2 #include "mainwidget.h M 

3 #include <qpushbutton.h> 

4 #include <kdialogbase.h> 

5 

6 MainWidget: : MainWidget(QWidget *parent,const char *name) 

7 : QWidget(parent,name) 

8 { 

9 setMinimumSize(200,80); 

10 setMaximumSize(200,80); 

11 

12 QPushButton ^button = 

13 new QPushButton("Popup",this); 

14 button->setGeometry(50,20,100,40); 

15 connect(button,SIGNAL(clicked()), 

16 this,SLOT(popupKdb())); 

17} 

18 

19 void MainWidget: : popupKdb() 

20 { 

21 KDialogBase * dialog = new KDialogBase(this, 

22 "kdbwidget'TRUE); 

23 dialog->exec(); 

24 delete dialog; 

25} 
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이 창문부품은 실례의 기본창문으로 사용된다. 그것은 오직 ’’Popup" 단추와 단추를 찰칵 
할 때마다 실행하는 처리부를 포함한다. 

단추를 찰칵할 때마다 KDialogBase 창문부품이 구성된다 (21 행). 23행에서 execO 호출은 그림 4-3 
과 같은 대화칸을 펼친다. 창문이 처음으로 나타날 때 OK 단추가 선택되므로 간단히 Return 또는 
Enter 건을 누르는것은 OK 를 찰칵하는것과 같다. 또한 그림으로부터 알수 있는것처럼 매개 단추는 
지정된 지름건을 가전다. 실례로 Alt +신를 누르는것은 Cancel 단추를 선택하는것과 갈다. 

Apply 단추에 처리부를 련결하지 않으면 그것은 아무 일도 하지 않는다. Cancel 과 OK 단 
추는 모두 대화칸을 완료한다. 단추들을 사용하기 위하여 간단히 OK 와 Apply 단추들을 대화 
칸으로부터 자료를 받아들이고 처리하는 처리부에 련결한다. 


제5절. KDialogBase 단추 


앞의 실례는 3개의 기 정 단추가 OK, Apply 그리고 Cancel 이 라는것을 보여 주었다. 그러 나 
다른 단추들도 있으며 자체의 3개 단추를 추가할수 있다. 다음 실례는 그림 4-4 와 같이 8개 
의 단추를 모두 보여 주는 창문을 현시한다. 



Userl V OK V Apply 


m. 




그림 4-4. KDialogBase 클라스의 단추선 택 

머리부파일과 프로그람의 기본함수는 이전 실례들과 같다. 프로그람들사이의 유일한 차 
이는 KDialogBase 의 구성자에 넘기는 인수모임이라는것이다. 

MainWidget 

1 /* mainwidget.cpp */ 

2 #include ’’mainwidget 上’’ 

3 #include <qpushbutton.h> 

4 #include <kdialogbase .h> 

5 

6 MainWidget: : MainWidget(QWidget ^parent,const char *name) 

7 : QWidget(parent,name) 

8 { 

9 setMinimumSize(200,80); 

10 setMaximumSize(200,80); 

11 

12 QPushButton *button = 

13 new QPushButton( n Popup n ,this); 
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14 button->setGeometry(50,20,100,40); 

15 connect(button,SIGNAL(clicked()), 

16 this,SLOT(popupKdb())); 

17} 

18 

19 void MainWidget: : popupKdb() 

20 { 

21 QString caption("All Buttons"); 

22 QString buttonl("Userl")； 

23 QString button2( M User2 M )； 

24 QString button3( M User3 M )； 

25 

26 int buttons = KDialogBase :: Ok 

27 | KDialogBase :: Apply 

28 | KDialogBase: : Cancel 

29 | KDialogBase :: Help 

30 | KDialogBase :: Default 

31 | KDialogBase : :User 1 

32 | KDialogBase : :User2 

33 | KDialogBase : :User3; 

34 

35 KDialogBase * dialog = new KDialogBase( 

36 this,// 부모 

37 "kdbwidget”, // 이 름 

38 TRUE,// 이행금지 

39 caption, // 제목 

40 buttons, // 단추마스크 

41 KDialogBase::Cancel, // 기정 단추 

42 FALSE,// 분리선 

43 buttonl, // 단추제목 

44 button2, // 단추제목 

45 button3); // 단추제 목 

46 dialog->exec(); 

47 delete dialog; 

48} 
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이 창문부품은 응용프로그람의 기본창문으로 사용된다. 그것은 찰칵할 때 KDialogBase 
창문을 현시하는 단추를 포함한다. 

처리부메쏘드 popupKdb () 는 12행에서 창조한 기본창문단추를 찰칵할 때마다 실행된다. 
KDialogBase 창문부품은 35행의 구성자에 의해 만들어진다. 이전의 실례에서 보여준것처럼 모 
든 인수는 정의된 기정값을 가지지만 이 실례는 그 매개의 값을 지정한다. 지정된 값들을 
표 4-1 에 서 설 명한다. 


표 4-1. 

KDialogBase 의 구성자가 받아들이는 파라메터들 

파라메 터 

설명 

부모 

부모창문부품인데 이것은 보통 KDialogBase 를 펼치는 창문부품이다. 기정 
값은 NULL 이 다. 

이름 

창문부품의 내 부이 름인 데 내 부목적 과 오유통보문을 발생 시키 는데 사용된 

다. 기정값은 NULL 이다. 

이 행 금지 

TRUE 로 설정 되 면 이 창문부품은 이 행 금지 로서 현시한다. FALSE 로 설정 

되 면 이 행 허 용으로 된 다. 기 정 값은 TRUE 이 다. 

제목 

창문꼭대기의 제목띠에 있는 제목의 본문. 기정값은 응용프로그람의 이름 

이다. 

단추마스크 

대화칸에서 능동으로 되여야 할 단추들을 지정 하는 lbit 기발들의 모임. 기 
정값은 3개의 단추 즉 Ok , Apply 그리고 Cancel 이다. 

기정 단추 

대화칸이 처음으로 나타날 때 선택되여야 할 단추(이 단추는 Return 혹은 
Enter 건에 응답한다:). 기정 값은 Ok 단추이다. 

분리선 

TRUE 이 면 단추우에 분리 선 이 생 겨난다. FALSE 이 면 분리 선 이 없다. 기 정 

값은 FALSE 이다. 

단추제목 

이 것은 사용자정 의단추에 나타나는 본문이다. 기 정값은 NULL 토서 사용 

자단추를 비게 한다. 


그림 4-4 에서 보여준것처럼 단추들의 순서는 KDialogBase 창문부품에 의하여 내적으로 
결 정한다. 포함할 단추들을 결정할수 있지 만 그것 들의 출현순서 는 늘 보여 주는 순서 이 다. 

표 4-2 는 KDialogBase 창문부품에서 사용할수 있는 모든 단추들을 보여준다. 이 단추들 
로부터 정보를 받는것은 적합한 KDialogBase 신호메쏘드에 자기 처리부메쏘드를 련결하는 문 
제 이 다. 대 화칸을 닫는 단추들은 결과를 가리 키 는 상태 코드를 설 정한다. 결 과코드를 엄 으려 
면 여기 에 보여준것처 럼 앞 실례 에서 46행과 47행사이에 행들을 삽입하여 야 한다. 
dialog -> exec (); 

int resultCode = dialog -> result (); 
delete dialog ; 

표 4-2. KDialogBase 의 단추와 신호 


77 




단추 

신호 

설명 

Apply 

applyClicked () 

Apply 단추와 Tty 단추가 모두 지정되면 Try 단추는 나타나지 

않는다. 

Cancel 

closeClicked () 

Close 단추대신에 사용할수 있다. 

Close 

closeClicked () 

Close 와 Cancel 가 모두 지정되면 오직 Close 만 나타난다. 결과 

코드는 FALSE 로 설정되고 대화칸은 닫긴다. 

Default 

defaultClicked () 


Help 

helpClicked () 

메 쏘드 invokeHTMLHelpO 를 호출하여 setHelp () 호출에 의해 

정의된 도움본문을 현시한다. 

No 

noClicked () 

대화칸이 통보칸방식일 때 Userl 단추위치에 나타난다. 결과코 

드는 FALSE 로 설정되고 대화칸은 닫긴다. 

OK 

okClicked () 

결과코드는 TRUE 로 설정되고 대화칸은 닫긴다. 

Try 

tryClicked () 

Apply 단추대신에 사용할수 있다. 

Userl 

userl Clicked 。 

구성 자에 서 인 수는 표식자를 지 정 한다. 이 단추는 통보칸방식 

에서 No 단추로 교체된다. 

User 2 

user 2 Clicked () 

구성 자에 서 인 수는 표식자를 지 정 한다. 이 단추는 통보칸방식 

에서 Yes 단추로 교체된다. 

User 3 

user 3 Clicked () 


Yes 

None 

이 단추는 대화칸이 통보칸방식 일 때 User 2 단추의 장소에 나 

타난다. 결과코드는 TRUE 로 설정되고 대화칸은 닫긴다. 


제 6 절 . KDialogBase 를 리용한 대화칸의 만들기 


다음 실례프로그람은 대화칸의 기초클라스로서 KDialogBase 를 사용하여 사용자가 본문 
행과 2개의 옹근수값을 지 정할수 있게 한다. 이 실례 에서 대화칸에 입 력 한 정보는 표식 자에 
의해 현시된 본문과 기본창문크기를 변경하는데 사용된다. 그림 4-5 는 대화칸(오른쪽)에 보 
여 준 값들에 의해 기 본창문(왼쪽)이 변경 된것 을 보여 준다. 



그림 4-5. Modify 대 화칸의 입 력 값으로 크기 변 경 되 는 기 본창문 
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Mainline 

1 /* kdbdata.cpp */ 

2 #include <kapplication.h> 

3 #include < kcmdlineargs . h > 

4 #include " mainwidget . h M 

5 

6 int main(int argc , char ** argv ) 

V{ 

8 KCmdLineArgs :: init ( argc , argv , ’’ kdbdata ", 

9 "KDialogBase demo", "0.0 ")； 

10 KApplication app ; 

11 MainWidget mainwidget ; 

12 mainwidget . show (); 

13 app . setMainWidget (& mainwidget ); 

14 retum(app. exec()); 

15} 

프로그람의 기본함수는 11행에서 MainWidget 를 만들고 13행에서 그것을 응용프로그람 
의 기 본창문으로 설 정한다. 

KApplication 객체는 10행에서 인수없이 만들어진다. 이것은 8행에서 KCmdLineArgs 클라 
스의 정적 init () 메쏘드가 호출되므로 가능하다. KCmdLineArgs 클라스는 지령행인수와 다른 정 
보를 보관하여 응용프로그람의 다른 부분에서 사용할수 있게 한다. 

MainWidget 머 리 부과 일 

1 /* mainwidget.h */ 

2 #ifndef MAINWIDGET_H 

3 #defme MAINWIDGET_H 

4 

5 #include < qwidget . h > 

6 #include < qpushbutton . h > 

7 #include < qlabel . h > 

8 

9 class MainWidget : public QWidget 

10 { 

11 Q_OBJECT 

12 public: 

13 MainWidget(QWidget * parent =0 ,const char * name =0); 
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14 private : 

15 QLabel * label ; 

16 QPushButton ^ button ; 

17 private slots : 

18 void popupKdb (); 

19 void slotSettings(QString &, int , int ); 

20 }; 

21 

22 #endif 

이 창문부품은 프로그람의 기본창문이다. 그것은 오직 1개의 단추와 1개의 표식자를 포 
함한다. popupKdbO 처 리 부는 대화칸을 펼치는데 사용된다. 처 리부 slotSettingsO 는 대화칸이 돌 
려준 값들을 받아들인다. 

MainWidget 

1 /* mainwidget.cpp */ 

2 #include " mainwidget . h ” 

3 #include " modify . h " 

4 #include < qpushbutton . h > 

5 #include < kdialogbase . h > 

6 

7 MainWidget : : MainWidget(QWidget * parent,const char * name ) 

8 : QWidget ( parent , name ) 

9{ 

10 setMinimumSize (200,140); 

11 

12 QString str("Modify Me ，，); 

13 label = new QLabel ( str , this ); 

14 label -> setAlignment ( Qt : : AlignCenter ); 

15 label -〉 setGeometry (50,20,100,40); 

16 

17 button = new QPushButton ( n Modify ", this ); 

18 button -> setGeometry (50,80,100,40); 

19 connect ( button , SIGNAL ( clicked ()), 

20 this , SLOT ( popupKdb ())); 

21 resize (10,10); 


22 
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23 void MainWidget: : popupKdb() 

24 { 

25 Modify *modify = new Modify (this, "modify”); 

26 connect( 

27 modify,SIGNAL(signalSettings(QString &,int,int)), 

28 this,SLOT(slotSettings(QString & ， int ， int))); 

29 modify->exec(); 

30 delete modify; 

31} 

32 void MainWidget::slotSettings(QString &str, 

33 int height,int width) 

34 { 

35 resize(width, height); 

36 label->setT ext(str); 

37} 

이 창문부품은 프로그람의 기본창문으로 사용된다 . 그것은 오직 표식자와 단추를 포함 
한다 . 단추는 대화칸을 펼치는데 사용된다 . 

18 〜 20 행은 단추를 만들어 창문에 배치하고 그것의 clicked() 신호를 국부처리부 
popupKbdO 에 련 결 한다 . 23 행 에 서 시 작하는 popupKbdO 처 리 부는 Modify 대 화칸을 만들고 
signalSettings () 신호를 slotSettings () 국부처리부에 련결한다 . exec () 를 호출하면 대화칸을 현시하 
고 그것을 닫을 때까지 기다린다 . 

32 행에서 시작하는 처리부이름 slotSettingsO 는 인수로서 3 개 값을 받아들이고 이 값들을 
사용하여 기본창문의 크기，그리고 기본창문의 표식자에 현시해야 할 본문을 지정한다 . 35 행 
의 resize 。 의 2 개 인수는 10 행에서 지정한 최소값보다 작은 값을 가질수 없고 그 이상의 값 
만을 가전다 . 

Modify 머 리 부파일 

1 /* modify.h */ 

2 #ifndefMODIFY_H 

3 #defme MODIFY_H 

4 

5 #include <kdialogbase.h> 

6 #include <qlineedit.h> 

7 #include <qpushbutton.h> 

8 

9 class Modify: public KDialogBase 
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10 { 

11 Q_OBJECT 

12 public: 

13 Modify(QWidget *parent=0,const char *name=0); 

14 private: 

15 QLineEdit *lineedit; 

16 QLineEdit * width; 

17 QLineEdit *height; 

18 private slots: 

19 void slotSendV alues(); 

20 signals: 

21 void signalSettings(QString &,int,int); 

22 }; 

23 

24 #endif 

이것은 대화칸의 머리부파일로서 KDialogBase 클라스를 직접 계승하며 그 자체의 처리 
부와 신호를 정의한다 . 

대화칸의 단추들로부터 응답을 받아들이기 위하여 slotSendValuesO 라는 처리부를 선언 
한다 . slotSendValuesO 를 실행할 때마다 새로운 본문과 값들을 가진 signalSettings() 신호를 보 
낸다 . 

대화칸 그 자체는 KDialogBase 를 직접 계승하므로 대부분의 기능은 이미 갖추고있다 . 
그러므로 재촉문，자료입 력창문부품 그리고 사용자가 새로운 값모임을 지정할 때마다 보내 
야 할 신호를 추가하려 는 경 우에 는 아래 와 같이 코드를 작성한다 . 

Modify 

1 /* modify.cpp */ 

2 #include "modify.h" 

3 #include <qlayout.h> 

4 #include <qlabel.h> 

5 

6 Modify: : Modify(QWidget ^parent,const char *name) 

7 : KDialogBase 여 arent,name,TRUE, "Modify") 

8 { 

9 QWidget *mainWidget = new QWidget(this, "modifymain"); 

10 

QVBoxLayout *vLayout = new QVBoxLayout(mainWidget, 10); 


11 
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13 lineedit = new QLineEdit(mainWidget); 

14 vLayout->addW idget(lineedit); 

15 

16 QHBoxLayout *hLayout = new QHBoxLayout(); 

17 vLayout->addLayout(hLayout); 

18 

19 QLabel *wLabel = new QLabel(’’width:’’ ， this); 

20 wLabel->setAlignment(Qt: : AlignCenter); 

21 hLayout->addWidget(wLabel); 

22 width = new QLineEdit(mainWidget); 

23 width->setMaximumWidth(50); 

24 hLayout->addWidget(width); 

25 QLabel *hLabel = new QLabel("height: M ,this); 

26 hLabel->setAlignment(Qt: : AlignCenter); 

27 hLayout->addWidget(hLabel); 

28 height = new QLineEdit(mainWidget); 

29 height->setMaximumWidth(50); 

30 hLayout->addWidget(height); 

31 

32 connect(this,SIGNAL(okClicked(void)), 

33 this,SLOT(slotSendValues(void))); 

34 connect(this,SIGNAL(applyClicked(void)), 

35 this,SLOT(slotSendValues(void))); 

36 

37 setMainWidget(mainWidget); 

38} 

39 void Modify::slotSendValues() 

40 { 

41 QString text = lineedit->text(); 

42 int w = (width->text()).toInt(); 

43 int h = (height->text()).toInt(); 

44 emit signalSettings(text,h,w); 

45} 

6 행에서 시작하는 구성자는 기초클라스에로 인수를 넘긴다 . 이행금지대화칸을 지정하고 
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창문에 제목을 할당하는 두개 인수가 기초클라스호출에 추가된다 . 

9 행에서 빈 창문부품이 만들어진다 . 이 창문부품은 11 행에서 만들어진 수직칸배치에 의 
해 배치된다 . QLineEdit 창문부품은 13 행과 14 행에서 수직칸의 꼭대기에 삽입된다 . 수평칸은 
16 행 에 서 창조되 고 수직창문부품의 두번째 칸에 들어 가는 창문부품들을 배 치 하는데 사용된 
다 . 이 수평 칸은 20 〜 30 행 에서 QLabel 과 QLineEdit 창문부품들로 채워 진다 . 37 행 에서 창문부품 
은 대화칸에 기본창문으로서 추가된다 . 

기 정단추들을 선 택 하므로 대 화칸에 나타나는 단추들은 대 화칸에 포함된 OK, Cancel 및 
Apply 단추들이다 . Cancel 단추가 선택될 때마다 대 화칸은 닫긴다 . 이 실례 에서 Cancel 단추에 
응답하여 얻어지는 작용은 없고 그것의 신호는 무시된다 . 32 와 34 행 에서 2 개의 connectO 메쏘 
드호출은 slotSendValues() 라는 처리 부를 실행 하게 한다 . 련 결들은 처리 부와 신호들이 모두 같 
은 객체에 있고 신호들이 계승되고 처리부가 국부적으로 정의되므로 this 로부터 오고 this 에 
로 돌아간다 . 

39 행에서 시작하는 처리부메쏘드는 사용자가 입력한 정보를 수집하고 자료를 사용하여 
신호를 발생시킨다 . 행편집칸의 본문은 표식자의 제목을 변경하는데 사용되므로 그것은 같 
은 형식으로 될수 있다 . QLineEdit 객체들이 돌려주는 너비와 높이는 QString 객체들이지만 
toInt() 호출에 의해 int 값들로 변환된다 . 

제 7 절 . KDialogBase 자료호출방법 

다음 실례프로그람은 앞의 실례를 변경한것이다 . 가끔 프로그람은 처리부와 신호를 러 
용하여 값들을 주고받을 대신에 대화칸을 리용하여 얻는것이 편리하다 . 이 수법은 대화칸이 
닫길 때 대화칸으로부터 자료를 엄을 필요가 있는 경우에 적용한다 . 

앞의 실례에서 Apply 단추는 창문을 닫지 않고 응용프로그람에 자료를 제공한다 . 이 실 
례는 그림 4-6 에 보여 준 창문에서 Apply 단추를 삭제하고 모든 처 리부와 신호들을 제거한 
다.(다만 대화칸을 펼치는 기 본함수는 제외한다 .) 



그림 4-6. 처리부들을 사용하지 않고 자료입력 
그러 기 위 하여 다음과 같이 modify.cpp 의 6 행 과 7 행 을 변경한다 . 
Modify: : Modify(QWidget *parent,const char*name) 

: KDialogBase(parent,name,TRUE, "Modify",Ok | Cancel) 
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다음 단계는 mainwidget.cpp 의 23 〜 37 행을 삭제하고 그것들을 다음 메쏘드로 교체한다 . 
void MainWidget: : popupKdb() 

{ 

Modify *modify = new Modify(this, "modify"); 

modify->exec(); 

if(modify->result() == TRUE) { 

QString text = modify->getText(); 
int height = modify->getHeight(); 
int width = modify->getWidth(); 
resize(width,height); 
label->setT ext(text); 

} 

delete modify; 

} 

대 화칸이 닫길 때 exec() 메 쏘드는 완료한다 . OK 단추가 대화칸을 닫는데 사용되 면 result() 
로부터의 돌림값은 TRUE 이고 그렇지 않으면 FALSE 이다 . 결과가 TRUE 이면 사용자입력자료 
를 창문부품들로부터 골어내 여 resizeO 와 se 件 ext() 를 호출하여 현시 를 변경 하는데 쓰인다 . 
exec() 메 쏘드는 대화칸을 닫아야 완료하고 Apply 단추가 주어지지 않았으므로 창문을 닫지 않 
는 단추선택을 결정하는데 처리부외에 방법이 없다 . 

값을 얻기 위하여 다음의 코드를 Modify 클라스에 추가한다 . 

QString Modify: : getText() 

{ 

retum(lineedit->text()) ; 

} 

int Modify: : getWidth() 

{ 

retum((width->text()) ,toInt()); 

} 

int Modify: : getHeight() 

{ 

retum((height->text()).toInt()); 

} _ 

알아두기 : 대화칸으로부터 정보를 얻는 방법은 많다 . 실례로 대화칸에 struct 의 주소를 
넘기고 거기에 자료를 채울수 있다 . 혹은 처리부，신호결합을 사용하여 직접 값들을 
읽을수 있다 . 심지어 대화칸을 가지고 후에 자기 프로그람에서 사용할수 있는 
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환경구성파일에 그 출력을 쓸수 있다. 


제 8 절 . KDialogBase 의 파생클라스 KMessageBox 

대화칸의 매우 일반적인 형래는 한행이나 두행의 본문을 현시하고 사용자가 간단히 
《예》라고 응답하거나 전혀 응답하지 않거나 간단히 대화칸을 완료하는 단추를 누르는것이 
다. KDialogBase 클라스는 통보대화칸을 작성 하는데 특별히 적합한 구성 자를 가지고 있고 
KMessageBox 클라스는 이 특수구성 자를 리 용하여 일 반적 으로 사용하는 통보대 화칸그룹을 실 
현한다. 

이 통보칸들은 모두 이행금지대화칸으로서 이동하기전에 사용자의 응답을 요구한다. 또 
한 매개 통보칸은 간단한 함수호출에 의해 펼쳐 지고 사용자가 응답하여 통보칸을 닫은 다음 
에야 호출측에로 되돌아간다. 이것은 간단히 자기 코드의 어떤 점에서 정적함수호출을 삽입 
하는 방법 으로 프로그람을 작성할수 있 다. 

다음 실례는 9개의 통보칸을 보여준다. 그림 4-7 에 보여준 기본창문은 9개 대화칸에 대 
응하는 단추를 하나씩 가지고있다. 대화칸으로부터 응답이 있을 때마다 창문의 밑에 본문이 
갱신되는 표식자가 있다. 그림은 마지막선택이 Yes 단추라는것을 보여준다. 



그림 4-7. 단추를 선택하여 통보칸을 현시 

Mainline 

1 /* mainxpp */ 

2 #include < kapplication . h > 

3 #include < kcmdlineargs . h > 

4 #include "mboxes 上" 

5 


86 







6 int main(int argc, char **argv) 

i{ 

8 KCmdLineArgs :: init(argc, argv, "mboxes", 

9 "Message Boxes", "0.0"); 

10 KApplication app; 

11 Mboxes mboxes; 

12 mboxes.show(); 

13 app.setMainWidget(&mboxes); 

14 retum(app. exec()); 

15} 

기 본함수는 Mboxes 객 체 를 만들어 응용프로그람의 기 본창문으로 설 치 한다 . 
Mboxes 머 리 부파일 
1 /* mboxes.h */ 

2#ifndefMBOXES_H 

3 #defme MBOXES_H 

4 



7 

8 class Mboxes: public QWidget 

9{ 

10 Q_OBJECT 

11 public: 

12 Mboxes(QWidget *parent=0,const char *name=0); 

13 private: 

14 QLabel *label; 

15 private slots: 

16 void button 1(); 

17 void button2(); 

18 void button3(); 

19 void button4(); 

20 void button5(); 

21 void button6(); 

22 void button7(); 

23 void button8(); 
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24 void button9(); 

25}; 

26 

27 #endif 

클라스선언에는 9 개의 단추 매개에 대하여 처리부를 하나씩 포함하고 창문의 아래에 
놓이는 표식자를 포함한다 . 

Mboxes 

1 /* mboxes.cpp */ 

2 #include "mboxes.h" 

3 #include <qpushbutton.h> 

4 #include <kmessagebox.h> 

5 #include <qlayout.h> 

6 

7 Mboxes::Mboxes(QWidget ^parent,const char *name) 

8 : QWidget(parent,name) 

9{ 

10 QPushButton ^button; 

11 QVBoxLayout *layout = new QVBoxLayout(this,3 )； 

12 

13 button = new QPushButton("Question Yes No M ,this); 

14 layout->addWidget(button); 

15 connect(button,SIGNAL(clicked()),this,SLOT(buttonl())); 

16 

17 button = new QPushButton("Question Yes No List",this); 

18 layout->addWidget(button); 

19 connect(button,SIGNAL(clicked()),this,SLOT(button2())); 

20 

21 button = new QPushButton("Warning Yes No",this); 

22 layout->addWidget(button); 

23 cormect(button,SIGNAL(clicked()),this,SLOT(button3())); 

24 

25 button = 

26 new QPushButton("Waming Continue Cancel",this); 

27 layout->addWidget(button); 

28 connect(button,SIGNAL(clicked()),this,SLOT(button4())); 
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29 

30 button = new QPushButton("Waming Yes No Cancel",this); 

31 layout->addWidget(button); 

32 connect(button,SIGNAL(clicked()),this,SLOT(button5())); 

33 

34 button = new QPushButton("Error",this); 

3 5 layout->addWidget(button); 

36 connect(button,SIGNAL(clicked()),this,SLOT(button6())); 

37 

38 button = new QPushButton( M Sorry n ,this); 

39 layout->addWidget(button); 

40 connect(button,SIGNAL(clicked()),this,SLOT(button7())); 

41 

42 button = new QPushButton("Information",this); 

43 layout->addWidget(button); 

44 connect(button,SIGNAL(clicked()),this,SLOT(button8())); 

45 

46 button = new QPushButton("About",this); 

47 layout->addWidget(button); 

48 connect(button,SIGNAL(clicked()),this,SLOT(button9())); 

49 

50 label = new QLabel(’’-",this); 

51 layout->addWidget(label); 

52 resize(10,10); 

53} 

54 void Mboxes::buttonl() 

55 { 

56 int result = KMessageBox: : questionY esNo(this, 

57 "Are you sure you want to delete\nall" 

58 "the files in this directory? 

59 "questionYesNo"); 

60 switch(result) { 

61 case KMessageBox::Yes: 

62 label->setText(QString("Y es M )); 
break; 


63 
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64 case KMessageBox: : No: 

65 label->setText(QString("No")); 

66 break; 

67 } 

68 } 

69 void Mboxes::button2() 

70 { 

71 QStringList list; 

72 list.append("fork M ); 

73 list.append( M spoon M ); 

74 list.append("knife"); 

75 int result = KMessageBox: : questionY esNoList(this, 

76 "Are you sure you want to delete\nall" 

77 "the items shown in the list? ", 

78 list, 

79 "questionYesNoList"); 

80 switch(result) { 

81 case KMessageBox::Yes: 

82 label->setText(QString( n Yes n ))； 

83 break; 

84 case KMessageBox: : No: 

85 label->setText(QString( M No")); 

86 break; 

87 } 

88 } 

89 void Mboxes::button3() 

90 { 

91 int result = KMessageBox: : wamingYesNo(this, 

92 "Reset all status codes? ", 

93 "wamingYesNo ")； 

94 switch(result) { 

95 case KMessageBox::Yes: 

96 label->setText(QString( M Yes")); 

97 break; 


98 


case KMessageBox: : No: 
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99 label->setText(QString( n No")); 

100 break; 

101 } 

102 } 

103 void Mboxes: :button4() 

104 { 

105 int result = KMessageBox: : wamingContinueCancel(this, 

106 "Overwrite the existing file? ", 

107 M wamingContinueCancel", 

108 QString ( ， ’ Overwrite")); 

109 switch(result) { 

110 case KMessageBox: :Continue: 

111 label->setText(QString( M Continue M )); 

112 break; 

113 case KMessageBox: : Cancel: 

114 label->setText(QString("Cancer')); 

115 break; 

116 } 

117} 

118 void Mboxes :: button5() 

119 { 

120 int result = KMessageBox: : wamingYesNoCancel(this, 

121 "Quitting without saving the file could result\n" 

122 "in loss of data. Save before quitting?", 

123 " wamingYesNoCancer'); 

124 switch(result) { 

125 case KMessageBox::Yes: 

126 label->setText(QString("Y es")); 

127 break; 

128 case KMessageBox: : No: 

129 label->setText(QString( M No")); 

130 break; 

131 case KMessageBox: : Cancel: 

132 label->setText(QString("Cancer')); 

133 break; 
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134 } 

135} 

136 void Mboxes::button6() 

137 { 

138 KMessageBox: : error(this, 

139 "Unable to save configuration data.’’); 

140} 

141 void Mboxes::button7() 

142 { 

143 KMessageBox::sorry(this, 

144 "The file you specified contains no data."); 

145 } 

146 void Mboxes: :button8() 

147 { 

148 KMessageBox: : information(this, 

149 "Pressing Esc will clear the window. "); 

150} 

151 void Mboxes::button9() 

152 { 

153 KMessageBox::about(this, 

154 ’’This is a simple about-box that can\n M 

155 "contain several lines of text"); 

156} 

기본창문으로 쓰이는 창문부품은 9 개의 단추와 1 개의 표식자를 만들고 그것들을 수직 
칸에 묶어놓는다 . 매개 단추는 하나의 통보칸을 만들어 현시하는 국부처리부에 련결된 
clicked() 신호를 가진다 . 

수직칸은 11 행에서 만들어진다 . D 〜 51 행은 기본창문을 이루는 9 개 단추와 표식자를 만 

든다 . 

13 〜 15 행은 단추를 만들고 54 행 에서 그것을 처 리 부 buttonlO 에 련결한다 . 56 행 에서 메쏘 
드 questionYesNo() 호출에 의해 그림 4-8 에 보여 주는 통보칸을 현시 하고 사용자가 응답하기 
를 기다린다 . 59 행의 문자렬파라메터는 통보칸창문의 제목이다 . 함수로부터 돌아온 값은 선 
택 된 단추를 결 정한다 . 다른 모든 통보칸들로부터 의 모든 돌림 값들은 KMessageBox 클라스에 
서 정의된다 . 
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그림 4-8. Yes/No 질 문통보칸 

알아두기 : 통보칸들로부터 의 돌림값은 론리형 이 아니 다 . 그것 들은 TRUE 또는 FALSE 

를 검사하는 식에 사용될수 없다 . _ 

61 행 의 switch 문은 질문 YesNo() 로부터 의 돌림 값이 Yes 인 가 No 인 가를 결 정한다 . 기 본창 
문바닥의 표식자는 결과를 표시하는 문자렬로 갱신된다 . 

모든 통보칸들은 본문행의 길이와 현시행수를 자체로 결정하므로 그 크기와 모양은 자 
체로 관리한다 . questionYesNo() 통보칸의 본문은 57 행과 58 행에서 정의된다 . 본문은 문자렬을 
분리할 때마다 삽입되는 ’\n’ 문자를 가지는 단일문자렬로 정의된다 . C++ 는 개 별적 인 행 에 있 
는 문자렬들을 하나의 큰 문자렬로 결합하여 코드에서 본문을 간단히 쓸수 있다 . 17 〜 19 행은 
단추를 만들고 69 행에서 시작하는 처리부 button2() 에 그것을 련결한다 . 이 통보칸은 75 행에 
서 만들어지고 그림 4-9 와 같이 현시되며 앞의 실례와 같이 예 또는 아니 질문을 제기하고 
또한 항목목록을 현시하는 창문을 포함한다 . 항목그룹을 가진 질문을 제시할 필요가 있을 
때 이 통보칸을 사용한다 . 이때 사용자가 항목을 추가하거나 삭제하는 방법은 없으며 오직 
목록전체의 허가나 거절로 된다 . 



그림 4-9. Yes/No 목록질 문통보칸 

현시목록은 기행에서 만들어지고 72~74 행에서 3 개 문자별들로 채워지는 QStringList 객 
체이다 . 이 문자렬목록은 78 행에서 인수로서 사용되고 79 행의 문자렬은 창문제목을 지정한 
다 . 
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21 〜 23 행에서는 단추를 만들고 89 행에서 시작하는 처리부 button3() 에 그것을 련결한다 . 
91 행에서 wamingYesNoO 호출은 56 행에서 questionYesNo() 호출과 거의 같다 . 그라프와 본문이 
현시되였다는것만 다르다 . 경고통보칸을 그림 4-10 에 보여준다 . 



그림 4-10. Yes/No 경 고통보칸 

25 〜 28 행은 단추를 만들고 103 행에서 시작하는 처리부 button4() 에 그것을 련결한다 . 
wamingContinueCancel() 통보칸은 사용자에게 어떤 조작을 시작하려고 한다는것을 알려주고 
사용자가 계속하겠는가 중지하겠는가를 결정할수 있도록 설계한다 . 그림 4-11 에 보여주는것 
처럼 이 실례는 현존파일을 덧쓰기한다는것을 사용자에게 경고한다 . 



그림 4-11. Continue/Cancel 경 고통보칸 

일부 통보칸들은 사용자가 단추표식자들을 무시하게 한다 . 이 실례의 108 행에서 인수로 
서 사용한 QString 은 기정의 Continue 로부터 Overwrite 로 단추표식자를 변경한다 . 즉 단추제목 
의 변경으로 돌림값은 달라지지 않고 110 행의 case 문은 Continue 값과 대조되여 제목이 
Overwrite 로 변경된다 . 

간단히 예 또는 아니라는 대답이 적합하지 않을 때가 있다 . 30 〜 32 행은 단추를 만들고 
118 행에서 시작하는 처리부 button5() 에 그것을 결합한다 . 이런 상황은 자주 발생한다 . 실례 
로 통보문 "Preparing to delete files. Do you wish to delete subdirectories also ? "을 고찰하자 . 사용자 
는 파일들과 함께 삭제하려는 등록부들을 지정하여야 한다 . 120 행에서 wamingYesNoCancel() 
호출에 의해 만들어진 통보칸을 그림 4-12 에서 보여준다 . 
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그림 4-12. Yes/No/Cancel 경 고통보칸 

34 〜 35 행은 단추를 만들고 136 행에서 시작하는 처리부 button6() 에 그것을 결합한다. 138 
행에서 errorO 호출은 그림 4-13 에 보여주는 통보칸을 만든다. 이 통보칸은 오직 자기 프로그 
탐이 정상적인 일을 할수 없을 때에만 사용하려고 하므로 돌림값을 가지지 않는다. 



그림 4-13. Error 통보칸 

38-40 행은 단추를 만들고 141행 에서 시작하는 처 리부 button 7() 에 그것을 련결한다. 함수 
sorryO 는 143행 에서 호출되 여 그림 4-14 에 보여 주는 창문을 현시 한다. 이 것은 프로그람이 실 
행을 계속할수 없는 경우를 위한것으로서 프로그람에서 조종할수 없다. 



그림 4-14. Sony 통보칸 

42 〜 44 행은 단추를 만들고 146 행에서 시작하는 처리부 button80 에 그것을 련결한다. 함 
수 mformationO 은 148 행에서 호출되고 그림 4-15 에 보여주는 창문을 현시한다. 이것은 처리 
에 영향을 주지 않는 정보를 포함하기 위한것이므로 사용자가 알아야 하는 경우가 있다. 
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Pressing Esc will clear the window. 

I[【ll 

그림 4-15. Information 통보칸 

46 〜 48 행은 단추를 만들고 151 행에서 처리부 button9() 에 그것을 련결한다 . 이것은 가장 
간단한 통보칸으로서 도형장식 을 하지 않고 값을 돌려 주지 않는다 . 그림 4-16 는 153 행 에 서 
about() 호출에 의해 만들어진 통보칸을 보여준다 . about() 로 시작하는 함수는 매우 간단한 
About 칸으로 사용될수 있다 . 



그림 4-16. 간단한 통보칸 

요 약 

대화칸을 만드는 방법은 많다 . 대화칸의 기본창문은 언제나 임의의 한개 창문부품이다 . 
그러므로 대화칸을 현시하고 사용자입력을 검색하며 창문을 배치하는 기구를 따로따로 써넣 
을수 있다 . 이 장에서 설명한 주요 부분은 다음과 갈다 . 

• 대화칸에 관한 특별한 요구조건이 있다면 기초클라스로서 QDialog 와 KDialog 를 사용 
하여 대화칸을 창조할수 있다 . 

• KDialogBase 는 창문부품을 삽입하는데 사용할수 있는 표준단추들과 배치관리기들을 
제공함으로써 대화칸의 구축을 돕는다 . 

• 대화칸은 사용자입력자료를 포함한 신호를 보낼수 있고 프로그람은 처리부를 사용하 
여 자료를 받을수 있다 . 

- KMessageBox 클라스는 정적함수집합으로서 매개 정적함수는 KDialogBase 를 사용하여 
표준대화칸을 구축한다 . 

대부분의 프로그람은 대화칸을 사용한다 . 대화칸은 단추를 리용하여 펼칠수 있고(이 장 
에서 설명 ) 프로그람내의 사건으로부터 펼칠수도 있으며(파일에 오유쓰기 등 ) 또는 사용자가 
차림표나 도구띠를 선택할 때 펼쳐질수 있다 . 프로그람의 형식을 표준화하는 한가지 방법은 
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이미 짜넣져있는 내부대화칸을 사용하는것이다 . 이 장은 간단한 내부대화칸의 일부를 설명 
하였으며 다음 장은 더 복잡한 대화칸들을 설명한다 . 
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제 5 장. 미리 정의된 대화칸들 


학습내용 

표준 About 대화칸의 만들기 , 

사용자가 파일이름을 선택할수 있게 하기， 

한개 대화칸안에서 여러개 창문부품들의 폐지만들기 , 

작업의 완성정도를 현시하기 . 

대단히 많은 대화칸이 KDE 와 (가에서 정의되 여있다 . 이 장은 몇가지 일반대화칸을 보여 
준다 . 대화칸클라스를 기초클라스로 하여 사용자대화칸을 만들고 대화칸의 실례를 만들고 
필요한 선택을 하여야 한다 . 이 장에서는 대화칸의 모든것을 설명하지 않는다 . 일부 특수대 
화칸들은 다른 장들에서 설명 한다 . 실례로 KFontDialog 는 10 장《서 체》에서， KColorDialog 는 11 
장《색》에 서 설 명한다 . 


제 1 절 . About 대화칸 

완성 된 모든 응용프로그람은 About 칸을 가진 다 . About 칸은 쏘프트웨어 의 계 승에 대 한 
부속정 보를 현시 하는 창문이 다 . 이 것은 프로그람작성 자들이 자기 이 름을 표시할수 있는곳이 
다 . About 칸은 단추로부터 펼 칠수 있으나 차림 표선 택 으로 더 자주 사용한다 . 

KAboutDialog 클라스는 매 우 유연하다 . 그것 은 작성 자가 포함하거 나 제 외 할수 있는 선 택 
적 인 부분품들의 집합이다 . 또한 서로다른 기본외형을 주는 2 개의 독립적 인 구성자를 가지 
고있다 . 기정으로 나타나는 유일한 단추는 대화칸을 닫는데 쓰이는 OK 단추이다 . 유연성을 
위하여 About 칸은 많은 선택을 제공하는 KDialogBase 클라스들을 계승한다 . (KDialogBase 클라 
스는 4 장에서 서술된다 .) 

KAboutDialog 클라스는 2 개의 구성자를 가지고있다 . 구성자들은 각이한 인수들을 가지는 
것 과 함께 각이한 방식 으로 대 화칸을 배 치 하며 매 개 방식 은 자체 의 항목들을 가지 고있다 . 
구성 자 I 는 표준 Qt 형 식 으로서 부모창문부품 , 내 부이 름 그리 고 창문이 이 행 금지인가 아닌가하 
는 3 개의 인수를 가진다 . 

KAboutDialog(QWidget ^parent,const char *name=0, bool modal=true) 

구성자 II 는 여러가지 배치형식들중 하나의 형식으로 대화칸을 현시하는 환경구성에 쓰 
이는 기발들을 비롯하여 많은 파라메터들(대부분이 기정값을 가진다)을 가지고있다 

KAboutDialog(int dialogLayout,const QString &caption, 
int buttonMask’int defaultButton,QWidget *parent=0, 
const char *name=0,bool modal=false,bool separator=false, 
const QString &userl =QString: :null, 
const QString &user2=QString::null, 
const QString &user3=QString: : null) 
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다음 실례는 구성자 I 과 II 를 모두 리용하여 가능한 배치를 만들고 현시한다 . 여기서 보 
여주는것보다 훨씬 더 많은 결합이 가능하다 . 프로그람의 기본창문은 그림 5-1 에 보여주며 4 
개 판의 About 대화칸을 펼치 는데 쓰이 는 단추들로 구성 되 여있다 . 



그림 5-1. 4 개의 About 대화칸을 펼치는데 쓰이는 단추들 
Show About 머 리 부파일 

1 /* showabout.h */ 

2 #ifndef SHOWABOUT_H 

3 #defme SHOWABOUT—H 

4 

5 #include <qwidget.h> 

6 

7 class ShowAbout: public QWidget 
8 { 

9 Q_OBJECT 

10 public: 

11 ShowAbout(QWidget *parent=0,const char *name=0); 

12 private slots: 

13 void emptyAbout(); 

14 void simpleAbout(); 

15 void kdeStandardAbout(); 

16 void appStandardAbout(); 

17 }； 

18 

19 #endif 

이 클라스의 유일한 목적은 필요한 대화칸을 펼치는것이므로 유일한 구성자와 4 개 단 
추에 의해 사용되 는 처 리 부가 있 다 . 매 개 처 리 부는 서 로 다른 판의 About 대 화칸을 펼 친 다 . 
ShowAbout 
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1 /* showabout.cpp */ 

2 #include <kapplication.h> 

3 #include <qpushbutton.h> 

4 #include <qlayout.h> 

5 #include <kaboutdialog.h> 

6 #include <kcmdlineargs .h> 

7 #include "showabout.h” 

8 

9 int main(int argc, char **argv) 

10 { 

11 KCmdLineArgs::init(argc, argv, "showabout”, 

12 "About Boxes","0.0 ")； 

13 KApplication app; 

14 Show About showabout; 

15 showabout. show(); 

16 app.setMainWidget(&showabout); 

17 retum(app. exec()); 

18} 

19 

20 ShowAbout: :ShowAbout(QWidget *parent,const char *name) 

21 : QWidget(parent,name) 

22 { 

23 QPushButton ^button; 

24 QVBoxLayout *box = new QVBoxLayout(this); 

25 

26 button = new QPushButton("Empty",this); 

27 box->addWidget(button); 

28 connect(button,SIGNAL(clicked()), 

29 this,SLOT(emptyAbout())); 

30 

31 button = new QPushButton( M Simple n ,this); 

32 box->addWidget(button); 

33 connect(button,SIGNAL(clicked()), 

34 this,SLOT(simpleAbout())); 


35 
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36 button = new QPushButton("KDE Standard”,this); 

37 box->addWidget(button); 

38 connect(button,SIGNAL(clicked()), 

39 this,SLOT(kdeStandardAbout())); 

40 

41 button = new QPushButton("App Standard”,this); 

42 box->addWidget(button); 

43 connect(button,SIGNAL(clicked()), 

44 this,SLOT(appStandardAbout())); 

45 

46 resize(10,10); 

47 box->activate(); 

48} 

49 void ShowAbout: : emptyAbout() 

50 { 

51 KAboutDialog *about = new KAboutDialog(0, ’’about"); 

52 about->exec(); 

53} 

54 void ShowAbout:: simpleAbout() 

55 { 

56 KAboutDialog *about = new KAboutDialog(0, ’’about’’); 

57 

58 about->setCaption( n Simple About Configuration"); 

59 about->setVersion( n Version 0.0.1 

60 

61 QPixmap logo; 

62 if(logo.load("tinylogo.png")) 

63 about->setLogo(logo); 

64 

65 about->setAuthor("Bertha D Blues”, 

66 "bertha@belugalake.com", 

67 M http://www.belugalake.com M , 

68 "Mallet Operator"); 

69 

70 about->setMaintainer( M Tony Stryovie' 1 , 
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71 ’’sttyovie@belugalake.com", 

72 ’’ht 中 :/ 八 vww.belugalake.com", 

73 "Finder of Lost Code"); 

74 

75 about->addContributor( n Walter Heater", 

7 6 M heat@belugalake. com", 

77 M http : //www.belugalake .com M , 

78 "Asker of Questions'*); 

79 

80 about->exec(); 

81} 

82 void ShowAbout: : kdeStandardAbout() 

83 { 

84 KAboutDialog *about = new KAboutDialog( 

85 KAboutDialog: :AbtKDEStandard, 

86 "KDE Standard Configuration", 

87 KDialogBase::Ok | KDialogBase :: Help, 

88 KDialogBase : :0k, 

89 this, 

90 "about", 

91 TRUE); 

92 

93 about->setTitle("The example that is all about About’’); 

94 about->setCaption("KDE Standard About"); 

95 about->setImage( n penguinl .png’’); 

96 about->setImageBackgroundColor(QColor("red M )); 

97 about->setImageFrame(TRUE); 

98 

99 about->addTextPage("Purpose", 

100 "This program is intended to provide an " 

101 "example that\ndemonstrates how to use " 

102 "the KAboutDialog .")； 

103 about->addTextPage("Version n , 

104 ’’Version 0.0.1 pre-alpha experimentalAn" 

105 "Saturday, April 1, 2000’’); 


102 





106 

107 about->exec(); 

108} 

109 void ShowAbout: : appStandardAbout() 

110 { 

111 KAboutDialog *about = new KAboutDialog( 

112 KAboutDialog: :AbtAppStandard, 

113 "App Configuration", 

114 KDialogBase : :Ok, 

115 KDialogBase::Ok, 

116 this, 

117 "about", 

118 TRUE); 

119 

120 about->setTitle("The example that is about About"); 

121 about->setProduct("ShowAbout M , 

122 "0.0.1 Pre-Alpha", 

123 "Bertha D Blues", 

124 "Saturday, April 1, 2000 ")； 

125 

126 about->addTextPage( n Purpose", 

127 "This program is intended to provide an ’’ 

128 "example that\ndemonstrates how to use ’’ 

129 "the KAboutDialog .")； 

130 about->addTextPage( n Version", 

131 ’’Version 0.0.1 pre-alpha experimental.\n M 

132 "Saturday, April 1, 2000’’); 

133 

134 about->exec(); 

135} 

9 〜 18 행은 프로그람의 기본함수로서 ShowAbout 클라스의 실례를 만들어 기본창문에서 
사용할 창문부품으로 삽입하고 완료를 기다린다. 

16 행 에 서 시 작하는 ShowAbout 구성 자는 수직 칸에 누름단추들을 배 치 한다. 4 개 단추는 각 
각 KAboutDialog 의 한개 판을 현시하는 처리부들중 하나와 련결된다. 

49 행 의 처 리 부 emptyAbout() 는 그림 5-2 에 보여 주는 빈 KAboutDialog 를 현시한다. 이 기 
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정판에 나타나는 유일한것은 대화칸을 닫는 0 K 단추와 일반적으로 응용프로그람용 줄임화상 
(logo graphics) 을 보관하는 위치 이다. 51 행에서 창조된 대화칸은 이행금지대화칸이므로 52 행에 
서 호출하는 메쏘드 exec() 는 사용자가 창문을 닫을 때까지 되돌려지지 않는다. 



그림 5-2. 빈 KAboutDialog 

54 행에서 시작하는 처리부 simpleAbout() 는 그림 5-3 에 보여준 빈 KAboutDialog 를 만드 
는데 사용한것과 같은 구성자를 리용한다. KAboutDialog 메쏘드는 현시가눙한 정보를 삽입하 
기 위하여 호출한다. 표 5-1 은 구성자 I 대화칸에 의해 사용하도록 특별히 설계된 메쏘드들을 
보여준다. 58 행에서 setCaption() 호출은 창문제목띠의 제목을 정의하며 setVersion() 호출은 창문 
꼭대 기 에 삽입할 판번호를 지 정한다. 



그림 5-3. 개발자들의 이름을 구성하는 KAboutDialog 
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표 5-1. 

구성자 I 용 KAboutDialog 메쏘드 

메쏘드 

목적 

setLogo() 

줄임 화상으로 현시 하려 는 픽 스매 프화상을 지 정 한다. 

setAuthor() 

이 름，전 자우편주소， URL, 쏘프트웨 어 저 자에 의 해 처 리 되 는 일 감을 지 정 

한다. 

setContributor() 

개 별적 인 기 부자의 이 름, 전자우편주소， URL 그리 고 쏘프트웨어 에 수 

행한 일감을 지정한다. 

setMaintainer() 

개 별적 인 관리 자의 이 름, 전자우편주소， URL ， 그리 고 쏘프트웨어 를 지 

원하기 위하여 수행한 일감을 지정한다. 

setVersion() 

현 재 쏘프트웨 어판을 지 정한다. 


61 행에서 창조한 QPixmap 는 62 행의 tinylogo.png 라는 파일로부터 화상정보를 적재한다. 
63 행의 se 仕 x)go() 호출은 화상을 창문의 왼쪽웃구석 에 현시할 줄임 화상으로 설정한다. 

65 〜 78 행은 setAuthor(), setMaintainer() 및 addCon 仕 ibutor() 호출에 의 해 이름과 주소를 추 
가한다. 한명의 저자와 1명의 관리자만 있을수 있으나 공헌자들이 많을수 있다. 매개 이름을 
삽입 하는 각이한 메 쏘드들이 있으며 모든 메 쏘드들은 갈은 파라메 터 모임 을 가지 고있다. 첫 
문자렬은 이름，둘째는 개인의 URL, 3 번째는 전자우편주소 그리고 마지막이 그 사람이 개발 
림에 수행한 일의 설명이다. 일단 현시되면 URL 과 전자우편주소 모두는 능동으로 된다. 즉 
그것들을 찰칵하여 전자우편을 보내거나 웹폐지를 실을수 있다. 

82 행 에서 시 작하는 처 리 부 kdeStandardAbout() 은 구성 자 II 를 사용하여 그림 5-4 에 보여 
주는 사용자정의 대화칸을 만든다. 85 행 에서 AbtKDEStandard 기발모임은 창문현시를 구성 하는 
요소들을 지정한다. 표 5-2 에는 포함하는 기발들과 요소들을 보여준다 .87 행의 인수들은 기초 
클라스 KDialogBase 에 어느 단추들을 포함하는가를 알리는데 사용된다. 이 실례에는 자동적 
으로 창문을 닫는 OK 단추와 Help 단추가 있다. 88 행에 지정된 단추는 대화칸이 처음으로 열 
릴 때 선택되는것이다. 


참고: 4 장의 KDialogBase 에서는 OK 와 Help 단추의 의미와 창조방법을 설명한다. 
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그림 5-4. 하나의 화상과 본문폐지를 가지는 KAboutDialog 
표 5-2. 창문현시를 구성 하는 KAboutDialog 기발 


기발이름 

설명 

AbtAppStandard 

AbtTabbed, AbtTitle 그리 고 AbtProduct 의 결 합을 허 용한다. 

Abtlmage AndT itle 

AbtPlain 과 AbtlmageOnly 의 결합을 허용한다.. 

AbtlmageLeft 

창문의 왼쪽에 화상을 현시한다. 

AbtlmageOnly 

다른 항목이 없으므로 화상을 중심에 현시한다. 

AbtlmageRight 

창문의 오른쪽에 화상을 현시한다. 

AbtKDEStandard 

AbtTabbed, AbtTitle 그리고 AbtlmageLeft 의 결합을 허 용한다. 

AbtPlain 

기 정 KAboutDialog 구성 요소들중 어 느것 도 현 시 되 지 않는다. 

이것은 다른 기발들과 결합하여 대화칸을 사용자정의하는데 사용될 

수 있다. 

AbtProduce 

응용프로그람이름, 판, 저자 그리고 날자를 현시한다. 

AbtTabbed 

사용자가 절환할수 있는 타브들을 가진 한개 이상 창문들의 집합을 

현시 한다. 

Ab 付 itle 

바로 제 목띠 아래 에 제 목을 현 시 한다. 
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대화칸에 어느 요소들을 현시해야 하는가를 알리는 기발들이 설정된 다음에도 요소들 
을 제공하여야 한다. 표 5-3 에는 구성자 II 를 사용할 때 가능한 메쏘드들을 보여준다. 


표 5-3. 

구성 자 N 용 KAboutDialog 메 쏘드들 

메쏘드 

목적 

addContainer() 

본문과 화상현시에 사용할수 있는 KAboutContainer 를 추가한다. 

addContainerPage() 

KAboutContainer 를 타브페지로서 추가한다. 그것을 리용하여 본 

문과 화상을 현 시할수 있 다. 

addPage() 

빈폐지를 타브페지집합에 추가한다. 그것을 리용하여 현시하고 

싶은 창문부품을 포함할수 있다. 

addTextPage() 

타브폐 지 집 합에 본문폐 지 를 추가한다. 

setlmage() 

줄임화상으로 현시하려는 화상을 지정한다. 

setImageBackground() 

화상을 현시할 때 배경으로 채우는데 사용할 색을 지정한다. 

setImageFrame() 

화상주위의 틀을 허용 또는 금지한다. 기정은 허용된다. 

setProduct() 

응용프로그람이름, 판，저자，날자를 정의하는 4 개 문자렬을 설 

정 한다. 

setTitleQ 

창문꼭대 기(바로 제 목띠아래)에 제 목을 삽입 한다. 


93 행의 setTitle() 호출은 기발설정이 Ab 件 itle 을 포함하기때문에 또한 현시하려는 제목을 
제공하는데 필요하다. 94 행의 setCaptionO 호출은 꼭대기에 있는 제목띠의 제목본문을 설정하 
기 위하여 기초클라스에 넘기는 호출이다. 

95 〜 97 행의 메쏘드호출은 줄임화상으로 사용하려는 화상파일의 이름，화상의 배경색 그 
리고 화상이 경 계선을 가지 는가 아닌가를 지 정한다. 배경 색 은 그림 5-4 에 이 미 보여 준것 처 럼 
창문의 빈 구역들과 화상의 투명부분의 채움색이다. 기정적으로 경계선을 그리지만 메쏘드 
setImageFram() 으로 그것을 허용하지 않을수 있 다. 

메쏘드 addTextPageO 는 여러번 사용할수 있는데 타브창문에 추가하려는 매개 폐지에 
대하여 한번씩 호출한다. 99 행과 103 행의 실례들에서 알수 있는것처럼 오직 인수들은 타브용 
표식자로 될 문자렬과 본문본체로 되여야 할 본문이다. 여러행에 본문을 형식화하려면 새행 
기호 V 을 삽입 해야 한다. 109 행에서 시작하는 appStandardAboutO 라는 처리 부는 그림 5-5 에 
보여 주는 대 화칸을 생 성한다. 
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The example that is about About 
ShowAbont 0.0.1 Pre-Alpha (Using KDE 3.5.1) 
□ Saturday. April 1, 2000. Bertha D Blues 



그림 5-5. 머리부와 타브폐지들을 가지는 KAboutDialog 
창문꼭대기의 본문은 2 개의 메쏘드호출에 의해 설정된다. 116 행의 setTitleO 호출은 웃끝 
의 중심 에 배치 되 는 제목본문을 설정한다. 121 행의 setProductO 호출은 본문의 나머 지 를 설정 
한다. 두 타브폐지는 126 행과 130 행에서 addTextPage() 호출에 의해 추가된다. 

제2절. QFileDialog 

QFileDialog 는 파일 또는 등록부의 이름을 사용자가 선택할수 있게 한다. 선택을 현존파 
일들로 제 한하거 나 사용자가 새 로운 파일 이 름을 입 력 하도록 지 정할수 있다. 또한 려 과기 를 
러용하여 파일이름들을 지정된 기준을 만족시키는것들로 제한할수 있다. 

ShowFile 머 리 부파 일 
1 /* showfile.h */ 


2 #ifndef SHOWFILE_H 

3 #defme SHOWFILE_H 

4 

5 #include <qwidget.h> 

6 #include <qlabel.h> 

7 #include <qstring.h> 

8 

9 class ShowFile: public QWidget 
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10 { 

11 Q_OBJECT 

12 public: 

13 ShowFile(QWidget *parent=0,const char *name=0); 



15 QLabel *filelabel; 

16 QString filename; 

17 private slots: 

18 void popupOpen(); 

19 void popupSave(); 

20 void popupDirectory (); 

21 void popupFilter(); 

22 }; 

23 

24 #endif 

머리부파일은 ShowFile 클라스를 선언한다. 클라스는 현재 파일 또는 등록부의 이름과 
그것을 현시하는데 사용된 QLabel 창문부품을 포함한다. 4 개 처리부메 쏘드는 각각 다른 방식 
으로 QFileDialog 를 펼치는 단추에 련결된다. 기본창문은 표식자와 단추들을 가지고있으며 
그림 5-6 에 보여준다. 



그림 5-6. 완전경로이름과 그것을 선택하는 4 가지 방법 

ShowFile 

1 /* showfile.cpp */ 

2 #include <kapplication.h> 

3 #include <qpushbutton.h> 

4 #include <qlayout.h> 

5 #include <qfiledialog.h 〉 

6 #include "showfile.h" 
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10 KApplication app(argc, argv, "showfile’’); 

11 ShowFile showfile; 

12 showfile. show(); 

13 app.setMainWidget(&showfile); 

14 retum(app. exec()); 

15} 

16 ShowFile: :ShowFile(QWidget ^parent,const char *name) 

17 : QWidget(parent,name) 

18 { 

19 QPushButton ^button; 

20 QVBoxLayout *box = new QVBoxLayout(this,0,3); 

21 

22 filelabel = new QLabel(’"’ ， this); 

23 filelabel->setAlignment(Qt: : AlignHCenter); 

24 box->addWidget(filelabel); 

25 

26 button = new QPushBu 竹 on("Select File to Open",this); 

27 box->addWidget(button); 

28 connect(button,SIGNAL(clicked()), 

29 this,SLOT(popupOpen())); 

30 

31 button = new QPushButton("Select Save File",this); 

32 box->addWidget(button); 

33 connect(button,SIGNAL(clicked()), 

34 this,SLOT(popupSave())); 

35 

36 button = new QPushButton("Select Directory",this); 

37 box->addWidget(button); 

38 connect(button,SIGNAL(clicked()), 

39 this,SLOT(popupDirectory())); 

40 


41 button = new QPushButton( M Filter Selection”,this); 

42 box->addWidget(button); 



43 connect(button,SIGNAL(clicked()), 

44 this,SLOT(popupFilter())); 

45 

46 resize(10,10); 

47 box->activate(); 

48} 

49 void ShowFile :: popupOpen() 

50 { 

51 QString name = QFileDialog: : getOpenFileName( MM , 

52 NULL,this); 

53 if(!name.isEmpty()) { 

54 filename = name; 

5 5 filelabel->setT ext(filename); 

56 } 

57} 

58 void ShowFile: : popupSave() 

59 { 

60 QString name = QFileDialog::getSaveFileName(filename, 

61 NULL,this); 

62 if(!name.isEmpty()) { 

63 filename = name; 

64 filelabel->setT ext (filename); 

65 } 

66 } 

67 void ShowF ile :: popupDirectory() 

68 { 

69 QString name = QFileDialog::getExistingDirectory(); 

70 if(!name.isEmpty()) { 

71 filename = name; 

72 filelabel->setT ext(filename); 

73 } 

74} 

75 void ShowFile: : popupFilter() 

76 { 

77 QString filter = 
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78 "All (*)\n ，， 

79 "C Source (*.c *.cc *.cpp *.cxx)\n" 

80 "C Header (* 上 ) \n ，， 

81 "Text (*.txt)\n M 

82 "HTML (*.html *.shtml *.HTML *.htm) 

83 QString name = QFileDialog: : getOpenFileName 

84 filter,this); 

85 if(!name.isEmpty()) { 

86 filename = name; 

87 filelabel->setText(filename); 

88 } 

89} 

8 〜 15 행은 프로그람의 기본함수로서 응용프로그람을 초기화한 다음 그림 5-6 에 보여주 
는 ShowFile 창문을 만들고 현시한다. 16 행에서 시작하는 구성자는 수직칸안에 표식자와 4 개 
의 단추를 포함하는 창문부품이다. 표식자는 최근에 선택한 파일 또는 등록부를 현시하는데 
사용된다. 단추들은 각각 QFileDialog 객체를 만들고 입력결과를 얻는 처리부에 련결된다. 4 가 
지 조작은 각각 갈은 현시형식 을 사용하지 만 제목띠제목과 단추조작은 좀 다르다. 그림 5-7 
은 QFileDialog 창문의 배치를 보여준다. 



그림 5-7. 파일과 등록부들을 현시하는 QFileDialog 
49행에서 시작하는 popupOpenO 처리 부는 사용자가 현존파일의 이름을 선택 할수 있는 
QFileDialog 창문을 연다. 51행에서 정적함수 getOpenFileName () 호출은 대화칸을 만든다. 첫째 
인수(이 실례에서 빈 문자렬)는 사용자에게 제안하려는 파일의 완전경로이름이다. 어떤 파일 
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이름도 지정되지 않으면 대화칸은 이 응용프로그람에 의해서 최근에 호출된 등록부나 현재 
등록부에 기초하여 열린다. 파일이 창문에서 선택될 때마다 단추는 본문을 0 K 로 바꾸고 사 
용자가 파일을 선택할수 있게 한다. 

58 행에서 시작하는 popupSave() 처리 부는 QFileDialog 를 열고 사용자가 현존파일을 선택 
하거 나 존재 하지 않은 파일의 이 름을 입 력할수 있게 한다. 60 행 에 서 getSaveFileNameO 호출은 
대화칸을 만든다. 구성자에 넘기는 첫 인수는 마지막으로 얻어진 파일의 이름이고 이것은 
창문에서 현재파일로 된다. 

67 행 의 popupDirectory() 처 리 부는 QFileDialog 를 사용하여 등록부을 선 택 한다. 이 메 쏘드 
에서 대화칸은 오직 선택된 등록부의 이름만 돌려준다. 사용자가 파일이름을 선택하면 파일 
이름은 생략되고 등록부경로만 돌려준다. 

75 행의 popupFilterO 처러부는 그림 5-8 에서 보여주는 파일이름려과기그룹을 지정한다. 려과 
기 들은 창문에 표시 할 파일 이 름들을 선 택하는데 사용되 는 파일 이 름확장자들의 집 합이 다. 려 과기 
들은 모두 77 행에서 시작하는 하나의 QStting 으로서 정의된다. 파일확장자들은 부류별로 조직되 
며 그림 5-8 에서 보여주는 "C Source" 와 같이 표시된다. 범주를 정의할 때 범주이름뒤에 괄호안에 
넣은 유효파일확장자들을 쓴다. 괄호안의확장자들은 공백으로 구분한다. 서로 다른 부류들을 행 
바꾸기기호 V’ 에 의해 구별하거나 한쌍의 반두점 에 의해 구별한다. 



그림 5-8. 표시할 파일들을 지 정 하는 려 과기 
알아두기: 거 의 모든 경우와 이 실례의 려 과기들은 특정한 확장자를 가진 파일들을 
선택하는데 사용된다. 그러나 려과기는 실제로 정규식이고 다른 형식에서 사용될수 
있다. 실례로 려과기 sh* 는 쇼로 시작하는 파일들만 렬거하도록 제한한다. 

그림 5 -7 과 5 -8 은 파일과 등록부이름의 배렬을 보여준다. 등록부들은 황갈색 직 4 각형들 
에 표식되고 항상 파일들앞에 렬거된다. 두 그룹에서 그것들은 ASCII 값에 의해 분류되므로 
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대문자들은 소문자앞에 온다. 렬거된 등록부가 기호련결이면 그 그림기호는 아래의 오른쪽 
구석에 작은 마크를 가전다. 

참고: 도형 파일조작을 론의 하는 13 장에 서 설 명 하는것 처 럼 자기 그림기 호들을 제 공함 
으로써 QFileDialog 창문의 모양을 사용자정 의할수 있다. 


제3절. QTabDialog 


QTabDialog 는 하나이상의 대화칸들을 하나로 묶어서 서로 절환하는데 사용할수 있는 
타브들을 제공한다. 다음 프로그람은 그림 5-9 에 보여주는 간단한 QTabDialog 를 만든다. 



그림 5-9. 현시되는 둘째 창문부품을 가진 QTabDialog 


ShowTabs 머 리 부과 일 


1 /* showtabs.h */ 


2 #ifiidef SHOWTABS—H 

3 #define SHOWTABS_H 

4 

5 #include <qwidget.h> 


7 class ShowTabs: public QWidget 

















8{ 

9 Q_OBJECT 

10 public: 

11 ShowTabs(QWidget *parent=0,const char *name=0); 

12 private slots: 

13 void slotTab(); 

14}； 

15 

16 #endif 
ShowTabs 

1 /* showtabs.cpp */ 

2 #include <kapplication.h> 

3 #include <qpushbutton.h> 

4 #include <qtabdialog.h> 

5 #include <qlayout.h> 

6 #include <kfontdialog.h> 

7 #include <kdatepik.h> 

8 #include <kselect.h> 

9 #include "showtabs.h" 

10 

11 int main(int argc, char **argv) 

12 { 

13 KApplication app(argc, argv, "showtabs"); 

14 ShowTabs showtabs; 

15 showtabs.show(); 

16 app.setMainWidget(&showtabs); 

17 retum(app. exec()); 

18} 

19 

20 ShowTabs::ShowTabs(QWidget ^parent,const char *name) 

21 : QWidget(parent,name) 

22 { 

23 QPushButton ^button; 

24 QVBoxLayout *box = new QVBoxLayout(this, 12); 








26 button = new QPushButton("Show Tab Dialog",this); 

27 box->addWidget(button); 

28 connect(button,SIGNAL(clicked()), 

29 this,SLOT(slotTab())); 

30 

31 resize(10,10); 

32 box->activate(); 

33} 

34 void ShowTabs:: slotTab() 

35 { 

36 QTabDialog *tab = new QTabDialog(this, "tabdial",TRUE); 

37 tab->setCaption("The QTabDialog Widget"); 

38 tab->setCancelButton(); 

39 

40 QWidget *fonts = new KFontChooser(this, ’’fonts"); 

41 tab-〉addTab(fonts, ’’Fonts"); 

42 

43 QWidget *date = new KDatePicker(this); 

44 tab->addTab(date, "Date"); 

45 

46 QWidget *hgradient = new KGradientSelector( 

47 KSelector: :Horizontal,this); 

48 tab->addTab(hgradient, "H Gradient’’); 

49 

50 QWidget *vgradient = new KGradientSelector( 

51 KSelector: : Vertical,this); 

52 tab->addTab(vgradient, ’’V Gradient"); 

53 

54 tab->show(); 

55} 

ShowTabs 클라스는 오직 QTabDialog 를 펼치는데 사용되므로 그 선언에 포함하는것은 구 
성자와 대화칸을 펼치는 처리부메쏘드뿐이다. 

H 행 에서 시 작하는 기 본함수는 ShowTabs 창문부품을 만들어 서 기 본창문창문부품으로서 
설치 한다. 

20 행 에서 시 작하는 ShowTabs 구성 자는 하나의 누름단추를 가지 는 용기 를 만든다. 28 행 에 
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서 단추는 slotTab() 라는 처리부메쏘드에 련결된 clicked() 를 가지고있다. 

34 행 에 서 시 작하는 처 리 부메 쏘드 slotTabQ 는 QTabDialog 를 만들고 현 시한다. 대 화칸은 
36 행에서 만들어진다. 첫째 인수는 대화칸의 부모창문부품이고 둘째는 거기에 할당된 이름 
이 며 세 번째 는 QTabDialog 가 이 행 금지라는것 을 지 정한다. 기 정 은 이 행 허 용대 화칸이 다. 

37 행 에 서 setCaption() 호출은 대 화칸창문의 제 목띠 에 현 시 하려 는 제 목을 설 정한다. 
setCancelButtonO 호출은 Cancel 단추가 대화칸의 부분으로 포함한다. 대화칸은 4 개의 단추를 
가질수 있다. 

기정적으로 OK 단추가 항상 있으나 자기가 좋아하는 다른 단추들을 지정할 필요가 있 
다. setDefauItButton(), setHelpButton() 및 setApplyButton() 호출에 의해 다른 단추들을 포함할수 
있다. 단추들을 포함하는 메쏘드들은 38 행과 같이 인수없이 호출되거나 단추본문을 지정하 
는 (setOkButton() 을 포함하여) 문자렬과 함께 호출될수 있다. 단추로부터 신호들을 받아들이기 
위 하여 applyButtonPressed(), cancelButtonPressed(), defaultButtonPressed() 및 helpButtonPressed() 에 
처리부들을 련결해야 한다. 

40 〜 52 행은 QTabDialog 에 포함되는 4 폐지(보통 타브폐지)를 만든다. 코드를 간단히 하 
기 위하여 표준 KDE 창문부품들중 4 개를 사용하며 그것들에는 사용자가 입력한 자료를 엄는 
데 필요한 기능이 없다. 자체로 창문부품들을 구축할수 있다. 보통 4 개의 창문부품으로부터 
정보를 읽어들이는 OK 와 Apply 단추에 련결된 처 리부가 있다. 

대화칸의 크기는 그것이 포함하는 창문부품들의 크기에 의해 결정된다. 대화칸은 제일 
큰 창문부품에 필요되는 높이와 너비로 표시되며 작은 창문부품들은 수직과 수평으로 중심 
에 배치된다. 타브를 리용하여 창문부품들을 서로 절환하는 대화칸이 점차 늘어나고있다. 또 
한 자료입력항목들이 차있는 폐지를 현시하지 않고 사용자에게 필요한 모든 항목들을 현시 
한다. 


제 4 절 . QProgressDialog 

가끔 프로그람은 몇초 또는 몇분 걸리는 일을 수행하여야 한다. 시간지연이 짧으면 유 
표를 시계화상으로 변경하여 《프로그람이 실행중에 있으니 잠간 기다리십시오》라고 전달할 
수 있다. 지연이 길면(실례로 15 초이상) 무슨 일을 하고 있는가에 대한 정보를 사용자에게 
주는것이 편리 하다. QProgressDialog 는 과제 완성 률을 현시 하는데 사용되며 지속시간이 충분히 
길 때에만 펼치도록 설정할수 있다. 

다음 프로그람은 QProgressDialog 를 사용하는 2 가지 방법을 보여준다. 그림 5-10 은 
QProgressDialog 창문을 펼치는데 쓰이는 2 개의 단추를 가지는 응용프로그람의 기본창문을 보 
여준다. 이 대화칸은 보통 자료전송, 큰 파일의 분류 혹은 시간이 걸리는 일의 진행상황을 
현시하는데 쓰이며 이 프로그람의 실례들은 시계의 진행상황에 기초하여 간단히 조작한다. 
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progress 


QST Seconds ： 
60 Seconds 


그림 5-10. 2 개 의 QProgressDialog 창문중 하나를 기 동한다 

Progress 머 리 부과 일 

1 /* progress 上 */ 

2 #ifndefPROGRESS_H 

3 #defme PROGRESS_H 

4 

5 #include <qprogressdialog.h> 

6 #include <qwidget.h> 

7 #include <qtimer.h> 

8 

9 class Progress: public QWidget 

10 { 

11 Q_OBJECT 

12 public: 

13 Progress(QWidget *parent=0,const char *name=0); 

14 private: 

15 QProgressDialog *progressDialog; 

16 QTimer *timer; 

17 private slots: 

18 void slot 15(); 

19 void slot60(); 

20 void timerStep(); 

21}； 

22 

23 #endif 

Progress 클라스는 3 개의 처리부와 하나의 시계를 가지고있다. 각각 15s 와 60s 동안 지속 
되는 진행상황대화칸을 기동하기 위하여 처리부메쏘드 slotl5() 와 slot60() 를 각각 호출한다. 
시계와 timerStepO 처리부는 내부적으로 경과시간을 추적하는데 사용된다. 

Progress 
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1 /* progress.cpp */ 

2 #include <unistd.h> 

3 #include <kapplication.h> 

4 #include <qpushbutton.h> 

5 #include <qlayout.h> 

6 #include "progress.h" 

7 

8 int main(int argc, char **argv) 

9{ 

10 KApplication app(argc, argv, ’’progress’’); 

11 Progress progress; 

12 progres s. show(); 

13 app.setMainWidget(&progress); 

14 retum(app. exec()); 

15} 

16 

17 Progress::Progress(QWidget ^parent,const char *name) 

18 : QWidget(parent,name) 

19 { 

20 QPushButton ^button; 

21 QVBoxLayout *box = new QVBoxLayout(this, 12); 

22 

23 button = new QPushButton(" 15 Seconds",this); 

24 box->addWidget(button); 

25 connect(button,SIGNAL(clicked()), 

26 this,SLOT(slotl5())); 

27 

28 button = new QPushButton("60 Seconds",this); 

29 box->addWidget(button); 

30 connect(button,SIGNAL(clicked()), 

31 this,SLOT(slot60())); 

32 

33 resize(10,10); 

34 box->activate(); 

35} 
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36 void Progress::slotl5() 

37 { 

38 int currentStep = 0; 

39 int steps = 15; 

40 

41 progressDialog = new QProgressDialog( 

42 "Fifteen seconds.."，’’Cancel’’, 

43 steps,this, ’’pgrs",TRUE); 

44 progressDialog->setCaption("Progress n ); 

45 while(currentStep < steps) { 

46 progressDialog->setProgress(currentStep++); 

47 if(progressDialog->wasCancelled()) 

48 break; 

49 sleep(l); 

50 } 

51 progressDialog->setProgress(steps); 

52 delete progressDialog; 

53 progressDialog = NULL; 

54} 

55 void Progress::slot60() 

56 { 

57 int currentStep = 0; 

58 int steps = 20; 

59 

60 progressDialog = new QProgressDialog(this, "prgs",TRUE); 

61 progressDialog->setCaption("Progress M ); 

62 progressDialog->setLabelText("Sixty seconds...; 

63 progressDialog->setCancelButtonText( M Quit M ); 

64 progressDialog->setTotalSteps(steps); 

65 progressDialog->setMinimumDuration(3000); 

66 

67 timer = new QTimer(this); 

68 connect(timer, SIGNAL(timeout()), 

69 this,SLOT(timerStep())); 

70 timer->start(3000,FALSE); 
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71} 

72 void Progress::timerStep() 

73 { 

74 int currentStep; 

75 int steps = 20; 

76 

77 if(progressDialog = NULL) 

78 return; 

79 

80 if(progressDialog->wasCancelled()) { 

81 delete timer; 

82 delete progressDialog; 

83 progressDialog = NULL; 

84 return; 

85 } 

86 currentStep = progressDialog->progress(); 

87 if(currentStep >= steps) { 

88 delete timer; 

89 delete progressDialog; 

90 progressDialog = NULL; 

91 } else { 

92 progressDialog->setProgress(currentStep +1); 

93 } 

94} 

8 행 에 서 시 작하는 프로그람의 기 본함수는 Progress 객 체 를 만들고 그것 을 제 일 웃준위창 
문으로 설 치한다. 제 일 웃준위창문부품은 17 행 에 서 구성 자에 의해 만들어 진 Progress 창문부품 
이다. 수직칸은 2 개의 누름단추를 포함한다. 단추들은 처리부 slotl50 와 slot600 에 련결된다. 
결과는 그림 5-15 에 보여주는 창문이다. 

36 행에서 시작하는 처리부메쏘드 slotl5() 는 순환안에서 진척상황띠를 사용하는 방법을 
보여준다. 진행상황률은 현재걸음수와 총걸음수의 비률에 의해 결정된다 .38 행은 현재걸음(시 
작걸 음)을 0 으로 지 정 하고 39 행 은 총걸 음수를 15 로 정 의한다. 41 행 의 구성 자는 
QProgressDialog 를 만들고 총걸 음수를 설 정한다. 또한 제 목본문과 창문부품이 름을 설 정 하고 
대 화칸이 이 행 금지 대 화칸이 라는것 을 TRUE 로 지 정 한다. 44 행 의 setCaptionG 호출은 대 화칸제 목 
띠 의 본문을 지 정한다. 

알아두기: 여기에 포함된 실례들은 들다 이행금지대화칸이지만 보통 이행허용진행상 | 
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황대화칸을 사용한다. 실례로 웹열람기가 하나 또는 두개 파일을 내리적재하고 있을 
때 매개 적재는 독립적인 진행상황대화칸을 가지며 여전히 열람기의 다른 기능을 호 
출할수도 있다. 

45 행 에 서 시 작하는 순환고리 는 진 척 상황띠 에 수행 할 조작을 모의 하기 위한것 이 다. 순환 
고리 가 하는 일은 현재 걸음계 수값을 중가하고 Is 동안 휴식 시 키 는것 이 다. 현실세계 응용프로그 
람에서는 다음 걸음의 값을 계산하고 그 값을 가지고 setProgressO 를 호출한다. 47 행에서 
wasCancelled() 호출은 사용자가 Cancel 단추를 선택하면 TRUE 를 돌려주므로 순환고리는 빨리 
완료한다. 결과는 그림 5-11 에 보여 준 진행상황창문이 다. 보통 일정한 시간이 지 나면 Cancel 
단추를 선택하여 중지코드를 순환안에 넣고 순환밖으로 이동한다. 



그림 5-11. 15 개 걸음을 가지는 QProgressDialog 
51 행의 setfrogress() 호출은 대화칸이 적당한 때에 닫기도록 한다. QProgressDialog 이행 금 
지대화칸이 실행을 시작할 때 우선 유표가 시계기호로 변한다. 그다음 대화칸이 펼쳐지기전 
에 잠간 기다린다. 현재값이 증가될 때마다 현시는 갱신된다. 마지막 걸음에 이르면 원래의 
유표를 되살리여 펼친다. 51 행의 setProgressO 호출은 순환이 최대걸음값에 이르지 못한채 완 
료할 때 필요하다. 

55 행에서 시작하는 slot60() 라는 처리부메쏘드는 그림 5-12 에 보여준것처럼 전혀 다른 
메 쏘드를 사용하여 QProgressDialog 를 만들고 갱신한다. 57 행과 58 행은 시작값을 0으로, 걸음 
수를 20으로 설 정한다. 대 화칸은 60 행 에 서 이 전 실 례 보다 더 간단한 구성 자에 의 하여 만들 
어진다. 61 〜 65 행의 메쏘드호출은 창문제목본문을 설정하고 대화칸에 나타나는 표식자의 본 
문을 지 정 하며 Cancel 단추의 본문을 바꾸고 그리 고 총걸 음수를 완료로 설 정한다. 



그림 5-12. 신호를 사용하는 QProgressDialog 

65 행의 setMinimumDuration() 호출은 지 연시 간을 3M0ms(3s) 로 설정한다. 이 것은 대화칸을 
펼치기 전에 기 다리는 시 간량이다. 











3000ms 로 설정하면 유표가 시계로 변화되고 3s 지날 때까지 아무일도 하지 않는다. 이리 
하여 대화칸은 3s 보다 적게 걸리는 과제에는 절대로 나타나지 않는다. 

67 〜 70 행은 시계를 만들고 실행을 시작한다. 시계의 timeoutO 신호는 이 클라스의 
timerStepO 에 련결된다. 70 행에서 start() 호출은 시계가 3s 에 끝나도록 초기화한다.둘째 파라메 
터를 FALSE 로 설정하면 이것은 한번만 현시되는 시계가 아니라는것을 의미하며 정지될 때 
까지 3s 마다 현시되면서 계속 실행된다. 둘째 파라메터를 TRUE 로 설정하면 시계는 오직 한 
번만 현시된다. 실제로 실행중에 있는 시계를 얻는 하나의 방법은 대체로 다른 방법과 비숫 
하다. 그것이 계속 실행되고 있다면 최후에는 없어져야 한다. 그것이 한번만 현시되는 시계 
이면 그것이 현시될 때마다 그것을 재기동시킬수 있다. 

72 행의 timerStepO 처리부는 시계가 발사할 때마다 실행한다. 사용자가 조작을 정지시키 
기 위하여 Cancel 단추를 선택하면 80 행의 wasCancelled() 호출은 TRUE 로 된다. 86 행의 
progressO 호출은 현재걸음값을 엄으며 87 행에서 그것이 끝에 도달했다는것을 발견하면 시계 
와 대화칸은 둘다 삭제된다. 그것이 여전히 진척중에 있다면 92 행의 setProgressG 호출은 현재 
걸음수를 증가시킨다. 

progressDialog 지적자는 대화칸이 해체될 때 NULL 로 설정되고 77 행에서 그것이 NULL 
인가를 시 험 한다. 이 시험은 QTimer 가 일하는 방법 이므로 필요하다. 동기를 얻기 위하여 
QTimer 는 사건대기렬에 특수사건을 삽입하며 사건대기렬은 응용프로그람과 비동기이므로 
QTimer 는 QProgressDialog 이 삭제될 때 시간사건이 입 력대기렬에 아직 있을수 있다. 이것은 
처 리 부 timerStepO 가 한번 이 상 실행된다는것을 의 미한다. 

요 약 

이 장은 KDE 와 Qt 대화칸들중 일부를 사용하는 방법을 보여주었다. 미리 정의된 대화칸 
은 더 많으며 이 대화칸들은 많은 항목들을 가지고있다. 이 장은 다음과 갈은 대화칸의 사 
용방법을 설명하였다. 

• 자기 응용프로그람이 KDE 체계의 부분으로 인정될수 있는 충분히 표준인 About 창문을 
만든다. 

• 파일과 등록부들을 제시하고 사용자가 선택하도록 한다. 

• 여 러 개의 창문부품들을 한곳에 배 치 하고 창문부품들을 서 로 절환하기 위한 타브대화 
칸을 사용자에게 제공한다. 

• 프로그람이 무엇인가 수행하고 있다는것을 사용자에게 보증하기 위하여 진척상황띠를 
현시 한다. 

이 장에서 설명하지 않은 대화칸들은 관련한 장들에서 설명한다. 그러나 대화칸은 펼칠 
수 있는 유일한것이 아니다. 다음 장은 차림표와 도구띠를 만들고 현시하는 과정을 시험한 
다. 
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제 6 장. 차림표와 도구[[I 


학습내용 

차림 표띠 를 가지 는 기 본응용프로그람창문의 제 공， 

창문부품안으로부터 차림 표의 펼치 기 , 

기 본응용프로그람창문안에 하나이 상의 도구띠 현시， 

기 본창문우의 상태 띠 안의 본문갱 신방법 . 

이 장은 프로그람의 요소를 호출하고 프로그람에서 무엇을 수행하는가에 대하여 사용 
자에게 통보하는데 쓰이는 창문부품들로 응용프로그람의 기본창문을 꾸미는 방법에 대하여 
학습한다. 이것은 대체로 응용프로그람의 기본창문에서 수행되며 KMainWindow 라는 특수한 
제 일웃준위창문클라스가 있다. 그것 은 차림 표띠 , 도구띠 그리 고 상태 띠 를 관리 하는데 필 요한 
모든것을 포함하고 있 다. 필요할 때 KMainWindow 는 이 항목들을 구성하고 자기 응용프로그 
탐의 기 본창문으로 사용하려는 창문부품을 삽입할 곳을 제공하며 그다음 포함되 여있는 여 러 
부분들과의 사용자교제 를 관리 한다. 이 창문부품들을 모두 만들고 관리할수 있 지 만 
KmainWindow 가 그것을 수행 하게 하는것이 더 간단하다. 

제 1 절 . KMainWindow 

KMainWindow 클라스는 응용프로그람의 제일웃준위창문에 리상적이도록 설계된 편리한 기 
능들을 결합한 창문부품이다. 그것은 기본창문부품(또한 보기창문부품라고 한다)을 보관할뿐아니 
라 차림표띠, 상태띠, 그러고 하나이상의 도구띠를 만들고 관리하는 기본기구를 조종한다. 
알아두기: KMainWindow 가 닫길 때에는 내부적으로 할당된 기억기를 해방하므로 
KMainWindow 는 항상 새로운 지령으로 창조되여야 한다. 그것이 대역객체로 또는 탄 
창에 정의된다면 프로그람은 기억기를 해방하려고 시도할 때 중단된다. ( KDE 2 까지 
KTMainWindow 으로 되 여 있 던 것 이 KDE 3 에 서 는 KMainWindow 로 변 경 되 였 다.) 

다음 실례프로그람은 그림 6-1 에 보여준것처럼 제일웃준위창문부품을 둘러싸는 하나의 차림표, 
도구띠，그리고 상태띠를 가지고 있는 제 일웃준위창문을 창조하는데 KMainWindow 를 사용한다. 



그림 6- l . KMainWindow 을 사용한 응용프로그람의 기본창문창조와 조종 
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SimpleMain 머 리 부파일 

1 /* simplemain.h */ 

2 #ifiidef SIMPLEMAIN_H 

3 #define SIMPLEMAIN_H 

4 

5 #include <kmainwindow.h> 

6 #include <kmenubar.h> 

7 #include <ktoolbar.h> 

8 #include <kstatusbar.h> 

9 

10 class SimpleMain: public KMainWindow 

11 { 

12 Q_OBJECT 

13 public: 

14 SimpleMain(); 

15 private slots: 

16 void slotExit(); 

17 bool queryClose(); 

18 private: 

19 void createMainWidget(); 

20 void createMenu(); 

21 void createstatusBar(); 

22 void createToolBar(); 

23}; 

24 

25 #endif 

5 〜 8 행은 KMainWindow 클라스와 기본창문의 부분으로 포함될 3 개 클라스를 선언하는 
머 리 부파일들을 포함한다 . 10 행 에서 SimpleMain 클라스선 언은 KMainWindow 를 기 초클라스로 
지 정 한다 . KMainWindow 의 실례를 직 접 구성 할수 있으며 한편 그것을 기초클라스로 사용하 
여 훨씬 더 많은 유연성을 제공한다 . 

SimpleMain 

1 /* simplemain.cpp */ 

2 #include <kapplication.h> 

3 #include <kcmdlineargs .h> 

4 #include <qpushbutton.h> 
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5 #include "simplemain 上 " 


7 int main(int argc, char **argv) 

8{ 

9 KCmdLineArgs :: init(argc, argv, "simplemain", 

10 "Simple Main", "0.0"); 

11 KApplication app; 

12 SimpleMain * simplemain = new SimpleMain(); 

13 simplemain->show(); 

14 retum(app. exec()); 

15} 

16 SimpleMain: :SimpleMain() : KMainWindow() 

17 { 

18 createMainWidget(); 

19 createMenu(); 

20 createStatusBar(); 

21 createToolBar(); 

22 } 

23 void SimpleMain: : createMainWidget() 

24 { 

25 QPushButton ^button = 

26 new QPushButton("Top Level\nWidget",this); 

27 setCentralWidget(button); 

28} 

29 void SimpleMain: : createMenu() 

30 { 

31 KMenuBar *menubar = menuBar(); 

32 QPopupMenu *popup = new QPopupMenu(); 

33 popup->insertItem("E&xit",this,SLOT(slotExit())); 

34 menubar->insertItem("&File",popup); 

35} 

36 void SimpleMain: : createStatusBar() 

37 { 

38 KStatusBar ^status = statusBar(); 

39 status->insertItem( M Status Bar",l); 
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40} 

41 void SimpleMain: : createToolBar() 

42 { 

43 KToolBar *toolBar = ToolBar(O); 

44 QPixmap pixmap("flag.png"); 

45 toolBar->insertButton(pixmap,5); 

46 } 

47 void SimpleMain::slotExit() 

48 { 

49 kapp->exit(0); 

50} 

51 bool SimpleMain: : queryClose() 

52 { 

53 retum(TRUE); 

54} 

프로그람의 기본함수는 7 〜 15 행에서 정의된다 . 11 행은 KApplication 객체를 만들고 KDE 
를 초기화한다 . 응용프로그람의 기본창문은 12 행에서 만들어진다 . app 객체와 SimpleMain 객체 
(즉 KMainWindow 객체)사이의 관계는 내부적으로 확립되므로 두 객체를 련결할 필요는 없다 . 
이것이 바로 응용프로그람에 유일한 KMainWindow 객체가 있는 리유이다 . 13 행에서 show() 호 
출은 기본창문을 현시하게 하므로 프로그람은 14 행에서 exec() 를 호출함으로써 지령순환고리 
에 들어간다 . 

구성자는 16 행에서 정의된다 . 구성자는 4 개 메쏘드를 호출하여 기본창문현시의 4 가지 
요소를 만든다 . 23 행에서 메쏘드 createMainWidgetO 는 응용프로그람의 기본창문으로 되는 창 
문부품을 만든다 . 이 실례에서 기본창문은 간단히 25 행에서 창조한 QPushButton 이다 . 27 행에 
서 setCentralWidget() 호출은 기 본창문 즉 보기 로서 그 창문부품을 삽입한다 . 

차림표띠는 29 행에서 시작하는 메쏘드 createMenu() 에서 구성되고 차림표띠는 31 행에서 
메쏘드 menuBarO 호출에 의해 만들어진다 . 이 메쏘드는 여러번 호출될수 있고 KMainWindow 
에는 하나의 차림표띠만 있으므로 늘 같은 KMenuBar 지적자를 돌려준다 . menuBar() 의 첫 호 
출은 차림표가 이미 존재하지 않을 때에만 새로 만든다 . 만약 필요하다면 자체의 차림표를 
만들고 다음과 같이 KMainWindow 에 그것 을 삽입할수 있다 . 

KMenuBar *myMenuBar = new KMenuBar(); 

setMenu(myMenuBar); 

차림표띠를 만들기 위하여 32 행에서 QPopupMenu 객체를 만든다 . 이 객체를 차림표항목 
들의 렬 이 튀 여나오는 용기 로서 동작시 키 기 위 하여 KMenuBar 에 삽입 할수 있다 . 실례의 33 
행 에서 insertltem() 호출에 의 해 하나의 단추를 삽입한다 . 단추는 “E&xit” 로 표식 되 며 처 리 부 
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메 쏘드 slotExit () 를 호출한다 . 34 행 에 서 insertltemO 호출은 차림 표띠 에 튀 여나오기 차림 표를 삽 
입한다 . 

그림 6-2 에 보여준것처럼 사용자는 창문의 측면으로 도구띠를 끌고가서 도구띠를 수직 
방향으로 변환한다 . 또한 창문의 오른쪽 혹은 바닥에 도구띠 를 배치할수 있다 . 



그림 6-2. 차림표띠와 도구띠의 위치선정 

36 행의 메 쏘드 createStatusBarO 는 statusBar() 를 호출하여 단일 행 의 본문을 현시할수 있는 
창문부품을 만들고 설치한다 . 프로그람은 상태띠 의 본문을 호출하므로 그것은 계속 갱신할 
수 있다 . 도구띠와 차림표띠와는 달리 상태띠는 다른 장소로 움직일수 없다 . 

41 행의 메쏘드 createTooffiarO 는 43 행의 toolbarO 를 호출하여 도구띠를 만든다 . 응용프로 
그람은 필요한만큼 도구띠를 가질수 있으므로 ID 번호를 인수로서 요구한다 . ID 를 가진 도구 
띠가 없으면 그 도구띠를 만들고 돌아온다 . 같은 ID 번호를 사용하면 늘 같은 도구띠를 돌려 
준다 . 이 실례 에서 하나의 픽스매프가 하나의 도구띠단추를 만드는데 사용된다 . 

도구띠는 그 부모창문밖으로 이동될수 있다 . 그림 6-3 은 도구띠의 왼쪽끝에 있는 손잡 
이 를 사용하여 그 부모창문으로부터 도구띠 를 분리하여 자기 의 독립창문으로 설정 한 결과를 
보여 준다 . 





그림 6-3. 류동차림표와 도구띠 
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47 행의 slotExitO 라는 메쏘드는 사용자가 차림표로부터 Exit 를 선택할 때마다 호출된다 . 여기 
서 일부 삭제하고 현재 보관하지 않은 자료를 보관할 필요가 있으나 이 실례는 간단히 응용프로 
그람의 exit() 를 호출한다 . kapp 라는 대역 변수는 늘 KApplication 객체의 지적자를 포함한다 . 

51 행의 queryCloseO 라는 처리 부메쏘드는 응용프로그람의 틀의 오른쪽웃구석에 있는 그 
림기호 표가 선택될 때 호출된다 . 이 처리부가 TRUE 를 돌려주면 응용프로그람은 즉시 닫기 
고 FALSE 를 돌려 주면 어 떤 작용도 없다 (X 단추로부터 오는 신호는 무시 된다 ). 

이것은 응용프로그람의 골격이다 . KMainWindow 가 대부분의 일을 수행하므로 제일웃준 
위창문은 단 몇행의 코드로 아주 복잡한 동작을 수행 할수 있다 . 이 장의 나머 지는 차림 표띠 
와 도구띠의 환경구성과 상태띠를 통한 정보현시방법을 자세히 설명한다 . 


제2절. 차림표[[I 


주로 차림표는 그 매개 항목에 련결된 처리부를 가진 단추들의 집합이다 . 차림표의 동 
특성은 단추들의 특정한 묶음을 임의로 사용할수 있게 함으로써 단추호출을 간단하게 한다 . 
단추들을 배치하고 장식하는 방법이 여러가지 있다 . 다음 실례는 그림 6-4 에 보여주는 창문 
을 만든다 . 이 차림 표띠 는 차림 표를 만드는 방법 을 설 명 하기 위한것 이 다 . 


File Toggles Pixmaps Submen 

iu Help 

Top Level 


Widget 



그림 6-4. 웃끝에 차림표띠를 가지는 응용프로그람 
머리부파일은 차림표단추가 선택될 때마다 호출되는 처리부들의 선언을 포함하지만 
한 상태에서 다른 상태에로 절환되는 차림표단추들의 상태를 추적하는데 필요한 비공개자료 
가 있다 . MenuMain 클라스는 KMainWindow 클라스를 계승하므로 이미 차림표를 현시하고 관 
리할 능력 을 가전 다 . 

MenuMain 머 리 부파 일 

1 /* menumain.h */ 

2 #ifndef MENUMAIN_H 

3 #defme MENUMAIN_H 

4 

5 #include <kmainwindow.h> 

6 #include <kmenubar.h> 

7 #include <ktoolbar.h> 
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8 #include <kstatusbar.h> 


10 class MenuMain: public KMainWindow 

11 { 

12 Q_OBJECT 

13 public: 

14 MenuMain(); 

15 private: 

16 QPopupMenu *checkPopup; 

17 int enableColorsID; 

18 int enableGraphicsID; 

19 private slots: 

20 void slotExit(); 

21 bool queryClose(); 

22 void slotNew(); 

23 void slotSave(); 

24 void slotSaveAs(); 

25 void slotClose(); 

26 void slotLogo(); 

27 void slotSub(); 

28 void slotEnableColors(); 

29 void slotEnableGraphics(); 

30 private: 

31 void createMainWidget(); 

32 void createMenu(); 

33}; 

34 

35 #endif 
MenuMain 

1 /* menumain.cpp */ 

2 #include <kapplication.h> 

3 #include <khelpmenu.h> 

4 #include <kcmdlineargs.h> 

5 #include <qpushbutton.h> 

6 #include <qwhatsthis.h> 
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7 #include ’’menumain.h” 


9 int main(int argc, char **argv) 

10 { 

11 KCmdLineArgs::init(argc, argv, "menumain", 

12 "Menu Main", "0.0 ")； 

13 KApplication app; 

14 MenuMain *menumain = new MenuMain(); 

15 menumain->show(); 

16 retum(app. exec()); 

17} 

18 MenuMain: : MenuMain() : KMainWindow() 

19 { 

20 createMainWidget(); 

21 createMenu(); 

22 } 

23 void MenuMain: : createMainWidget() 

24 { 

25 QPushButton ^button = 

26 new QPushButton("Top Level\nWidget",this); 

27 QWhatsThis :: add(button, 

28 n Button\n\n M 

29 "This button is used as the top\n" 

30 "level widget for this example. It\n M 

31 "is very safe to click the button\n” 

32 "because it doesn’t do anythingAn"); 

33 setCentralWidget(button); 

34} 

35 void MenuMain: : createMenu() 

36 { 

37 QPopupMenu *popup; 

38 QPopupMenu *popup2; 

39 QPixmap pixmap; 

40 KMenuBar *menubar = menuBar(); 

41 
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42 popup = new QPopupMenu(); 

43 popup->insertItem("&New M ,this, 

44 SLOT(slotNew()),ALT+Key_N); 

45 popup->insertItem("&Save n ,this, 

46 SLOT(slotSave()),CTRL+Key_S); 

47 popup->insertItem("Save As",this, 

48 SLOT(slotSaveAs()),CTRL+SHIFT+Key_S); 

49 pixmap.load("flag.png"); 

50 QlconSet iconset(pixmap); 

51 popup->insertItem(iconset, "Close",this, 

52 SLOT(slotClose())); 

53 popup->insertSeparator(); 

54 popup- 〉 insertItem("Exit" ， this, 

55 SLOT(slotExit()),ALT+Key_X); 

56 menubar->insertItem("&File",popup); 

57 

58 checkPopup = new QPopupMenu(); 

59 checkPopup->setCheckable(TRUE); 

60 enableColorsID = checkPopup->insertItem( 

61 "Enable Colors",this,SLOT(slotEnableColors())); 

62 checkPopup->setItemChecked(enableColorsID,TRUE); 

63 enableGraphicsID = checkPopup->insertItem( 

64 ’’Enable Graphics",this, 

65 SLOT(slotEnableGraphics())); 

66 checkPopup->setItemChecked(enableGraphicsID,FALSE); 

67 menubar->insertItem("&Toggles M ,checkPopup); 

68 

69 popup = new QPopupMenu(); 

70 pixmap.load("tinylogo.png"); 

71 popup->insertItem(pixmap,this,SLOT(slotLogo())); 

72 pixmap.load("qtlogo.png M ); 

73 popup->insertItem(pixmap,this,SLOT(slotLogo())); 

74 menubar->insertItem("&Pixmaps M ,popup); 

75 

76 popup = new QPopupMenu(); 
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77 popup2 = new QPopupMenu(); 

78 popup2->insertItem("Horizontar',this,SLOT(slotSub())); 

79 popup2->insertItem( M Verticar',this,SLOT(slotSub())); 

80 popup->insertItem("Orientation... M ,popup2); 

81 menubar->insertltem(" Submenu",popup); 

82 

83 KHelpMenu *help = new KHelpMenu(this, 

84 "Text that will appear in\n" 

85 "a very simple About box’’); 

86 popup = help->menu(); 

87 menubar->insertItem("&Help n ,popup); 

88 } 

89 void MenuMain: : slotExit() 

90 { 

91 kapp->exit(0); 

92} 

93 bool MenuMain: : queryClose() 

94 { 

95 retum(TRUE); 

96} 

97 void MenuMain: : slotEnableColors() 

98 { 

99 if(checkPopup->isItemChecked(enableColorsID)) 

100 checkPopup->setItemChecked(enableColorsID,FALSE); 

101 else 

102 checkPopup->setItemChecked(enableColorsID,TRUE); 

103 } 

104 void MenuMain: : slotEnableGraphics() 

105 { 

106 if(checkPopup->isItemChecked(enableGraphicsID)) 

107 checkPopup->setItemChecked(enableGraphicsID,FALSE); 

108 else 

109 checkPopup->setItemChecked(enableGraphicsID,TRUE); 

110 } 

111 voidMenuMain::slotNew() {} 
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112 void MenuMain: : slotSave() {} 

113 void MenuMain::slotSaveAs() {} 

114 void MenuMain: : slotClose() {} 

115 void MenuMain::slotLogo() {} 


116 void MenuMain::slotSubO {} 

10 행에서 시작하는 프로그람의 기본함수는 MenuMain 객체를 만들고 그것을 현시하며 
exec() 를 호출하고 입력을 기다린다 . 15 행에서 시작되는 MenuMain 의 구성자는 
createMainWidgetO 를 호출하여 창문부품이 기본창문으로 작용하도록 하고 그 다음 
createMenuO 를 호출하여 창문꼭대기 에 차림표띠를 추가한다 . 

23 행에서 시작하는 메쏘드 createMainWidgetO 는 누름단추를 만들고 그것을 응용프로그 
람의 기본창문으로 설치한다 . 단추는 33 행의 setCentralWidget() 호출에 의해 설치된다 . 27 행의 
QWhatsThis :: add() 호출은 단추와 설명 본문을 련결하여 Help 차림 표로부터 본문을 현시할수 있 
도록 하기 위한것 이 다 . 

35 행의 메쏘드 createMenu() 는 차림표띠와 그 항목들을 모두 만든다 . KMainWindow 창문 
부품에 하나의 차림표띠가 있고 37 행에서 그 주소를 엄어서 menubar 지적자에 보관한다 . 실 
제로 차림표띠는 menuBar() 를 호출할 때까지 존재하지 않지만 다음번 menuBar() 호출은 같은 
차림 표띠 지적 자를 돌려 준다 . 

차림 표띠 에 나타나는 매 개 단추는 하나의 QPopupMenu 객 체 를 표시 한다 . 첫 째 단추는 42 
행 에서 만들어 지고 56 행 에서 차림표띠 에 추가된다 . 42 〜 56 행 에서 많은 항목들이 튀 여나오기 
차림표에 삽입되 여 그림 6-5 에 보여주는것과 갈은 차림표가 생긴다 . 


「[■■e toggles Pixmaps Submenu 

New AK 씨 

Save CW+S 

Save As Ctrl+ShiR+S 

公 、 Close 

Help 

Exit Alt+X 



그림 6-5. 그림기호와 지름건을 가진 차림표 

56 행의 insertltem() 호출은 차림표이름이 ” File” 이고 지름건이 Alt-F 라는것을 지정 한다 . 즉 
간단히 "File” 대신에 ’’&File" 라고 표식 자를 쓰면 그것이 현시 될 때 밑선이 있는 글자로 표시 
되며 Alt-F 건결합을 누르면 마우스로 차림표를 선택한것과 같아진다 . 올리와 내리화살표건으 
로 차림 표항목을 찾고 Return 또는 Enter •건으로 선택 한다 . 

K New" 로 표식된 항목은 43 행에서 insertltemO 호출에 의해 만들어진다 . 지름건은 상수값 
ALT+Key_N 에 의 해 지 정된다 . 이 것은 차림 표항목을 선택하기 위한 지름길 이 며 응용프로그람 
이 건반초점을 가질 때마다 ALT-N 을 누르면 마우스로 New 항목을 선택한것과 같은 결과를 
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산출한다 . 지름건은 그림 6-5 과 같이 오른쪽에 나타난다 . 문자 N 앞의 &는 밑선이 그려지게 
하지만 차림표띠와 달리 이것은 자동적으로 지름건을 할당하지 않는다 . 밑줄을 그리는가 아 
닌 가는 선 택 할수 있 다 . ’’ Save As’’ 선 택 은 지 름건 을 가지 만 밑 줄문자를 가지 지 않는다 . 

지름건은 건과 그 수식자들을 지정하는 특수값에 의해서 정의된다 . 3 개의 수식자 즉 
ALT, CTRL 및 SHIFT 를 사용할수 있 다 . 건만 사용하거나 수식 건 한개，두개 , 또는 3 개를 결 
합하여 사용할수 있다 . 실례로 47 행에서 정의된 "Save As" 항목은 CTRL 과 SHIFT 수식자를 모 
두 사용한다 . 많은 건을 지름건으로 사용할수 있다 . 다음은 일반적으로 사용하는 건들을 보 
여준다 . 

정의된 건은 1 개 건반에 있는것보다 더 많다 . 그러나 여기에 제시하는 대부분의 건은 
아주 쓸모있다 . 자기가 사용하려는 특수건이 있다면 qnamespace.h 라는 Qt 머리부파일에서 230 
개이상의 건을 찾을수 있다 . 

Key_0 through Key_9 
KeyApostrophe 
Key_Asterisk 
Key_A through Key_Z 
Key_Backslash 
KeyBackSpace 
KeyBackspace 
Key 一 BraceLeft 
KeyBraceRight 
KeyBracketLeft 
KeyBracketRight 
KeyCapsLock 
KeyColon 
Key_Comma 
KeyDelete 

49 〜 52 행에 정의된 Close 차림표항목은 그림 6-5 에서 그 왼쪽에 그림기호와 함께 현시된 
다 . 그러기 위하여 첫째로 화상을 포함하는 픽스매프를 만들어야 한다 . 이것은 49 행에서 
flag.png 이라는 국부디스크파일로부터 자료를 적재하여 수행한다 . 둘째로 50 행에서처럼 픽스 
매프로부터 QlconSet 객체를 만들어야 한다 . 차림표항목 자체는 48 행에서 첫 인수로서 
QlconSet 를 넘기는 insertltem() 호출에 의해 만들어지고 그림기호들을 포함하지 않는 경우에 
인수들은 이전과 같다 . 

참고 : 13 장 《도형 조작》은 픽 스매 프를 만드는 다른 방법 을 설 명한다 . | 

53 행은 Close 와 Exit 사이에 수평분리선을 삽입하여 File 차림표를 완성한다 . 54 행과 55 행 
은 Exit 차림표성원을 만든다 . 


Key 一 Down 

KeyEnd 

KeyEnter 

KeyEqual 

KeyEscape 

Key_Fl through Key_F35 

KeyHome 

Keylnsert 

KeyLeft 

KeyMinus 

Key_Next 

KeyNumLock 

KeyPageDown 

KeyPageUp 


KeyPeriod 

Key_Plus 

KeyPrint 

KeyQuoteDbl 

KeyRetum 

Key_Right 

Key_ScrollLock 

KeySemicolon 

KeySlash 

Key_Space 

KeySysReq 

Key_Tab 

KeyUnderscore 

Key_Up 
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그림 6-6 은 on 과 off 를 절환할수 있는 한쌍의 검 사단추를 가지 는 차림 표를 표시한다 . 검 
사표식자는 단추가 on 으로 절환될 때 나타난다 . 그림 에서 Enable Colors 단추는 on 이고 Enable 
Graphics 단추는 off 이 다 . 


File I Pixmaps Subm< 

mu Help 

녀 LMible Colon 


tiMblc (打여) 


Widget 



그림 6-6. 절환단추를 가진 차림표 


Toggles 차림표는 58 행에서 만들어지고 74 행에서 차림표띠에 삽입된다 . 59 행의 setCheckableO 호 
출은 모든 항목이 on 과 off 를 절환할수 있도록 튀 여나오기차림표를 구성한다 . 이리하여 간단히 on 
과 off 를 절환함으로써 튀여나오기차림표의 임의의 항목을 절환항목으로 만든다 . 

실제로는 자동적으로 절환되지 않는다 . 97 〜 110 행에서 절환단추용의 2 개 처리부는 
isItemCheck () 를 호출하여 현재절환상태를 검사한 다음 setItemChecked () 를 호출하여 그것을 
다른 상태로 절환한다 . 처리부메쏘드에서 단추들을 절환하는데 인수들이 필요하므로 머리부 
파일의 16 〜 18 행 에서 2 개 단추의 正)번호와 함께 튀 여나오기 차림 표의 지 적 자를 보관할 필요 
가 있다 . ID 번호는 60 행 과 63 행 에 서 itemlnsertO 로부터 의 돌림 값이 며 튀 여나오기 차림 표에서 
특정한 항목을 호출하는 유일한 방법이다 . 

본문대 신 에 픽 스매 프로 차림 표를 장식할수 있다 . 그림 6-7 은 단추들에 픽 스매 프를 사용 
하는 차림표들을 보여준다 . 그 차림표들은 본문차림표단추들처럼 작업하므로 지름건을 가질 
수 있고 절환단추일수 있다 . 그림에서 어떤 픽스매프는 다른 것보다 클수 있으므로 픽스매 
프의 크기 에 따라 매개 차림표항목이 확장된다는것을 알수 있다 . 



File Toggles | Pixmaps Submenu Help 


— „ Qt U 

그림 6-7. 단추에 픽스매프를 사용하는 차림표 
픽 스매 프를 가진 튀 여나오기 차림 표는 70~74 행 에 서 만들어 진 다 . 같은 QPixmap 객 체 가 
두 단추에 사용되며 이것은 insertltemO 메쏘드가 자기의 국부사본을 만들기때문에 동작한다 
는것을 알아야 한다 . 픽스매프와 본문단추사이의 유일한 차이는 기행과 73 행에서 첫 인수의 
형이고 QPixmap 객체참고가 첫 인수이다 . 
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보조차림 표는 다른 차림 표에 항목들중의 하나로서 튀 여 나오기 차림 표를 삽입 하여 만들 
수 있다 . 76 〜 81 행 은 popup2 라는 이 름의 두번째 튀 여나오기 차림 표를 만들고 "Orientation ..." 로 
표식하여 부모차림표에 삽입한다 . 결과 차림표를 선택하면 그림 6-8 과 같이 보인다 . 



Top Level Vertical 

Widget 


그림 6-8. 보조차림표를 가진 차림표 

KHelpMenu 객체는 80 행에서 창조되고 86 행과 87 행에서 차림표띠의 제일 오른쪽 성원으 
로서 설치된다 . 그 결과차림표를 그림 6-9 에 보여준다 . 



QQ] Contents FI 

Top Level 

Whal，3 Ihis SI 빠 if 1 

Widget 

Report Bug... 


4? About menumain... 


~| About KDE... 


그림 6-9. 표준방조차림표의 배치 

’’Contents ’’ 항목은 지 름건 F1 을 가지 며 방조본문을 현시한다 . 본문자체 는 HTML 로서 작 
성자가 제공한다 . 파일이름은 응용프로그람의 이름에 의존된다 . menumain 라는 이름의 이 실 
례에서 영 문판 방조나무의 색 인파일은 다음과 같다 . 


/usr/doc/kde/HTML/en/menumain/index.html 

’’What’s This ” 차림표항목은 현시를 위한 모든 창문부품이 그자체에 대한 설명본문을 현 
시할수 있도록 선택방식으로 응용프로그람을 절환한다 . 이 실례의 24 행에서 정적메쏘드 
QWhatsThis 호출은 기 본창문으로 사용된 단추에 설명 본문을 삽입한다 . 차림 표를 선택할 때 
유표를 물음표로 변경한다 . 물음표는 항목을 선택 할 때 본문을 현시하는데 사용된다 . 본문은 
그림 6-10 과 같이 간단한 경계선과 노란색 배경을 가지는 창문에 현시된다 . 
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Button 

This button is used as the top 
level widget for this example. It 
is very safe to click the button 
because it doesnl do anything. 


그림 6-10.’’What’s this ?" 에 대 한 응답으로서 현시 된 본문 
차림표의 밑에 있는 2 개의 단추는 About 대화칸들이다 . 응용프로그람의 기정 About 대화칸 
은 OK 단추를 가지는 간단한 본문블로크이고 KDE 의 현재판에 대한 정보를 가지는 표준 
About 칸이 있다 . 

KHelpMenu 를 사용하여 기본 About 칸을 자기의 것들중 하나로 바꿀수 있다 . 이를 위 하여 
KHelpMenu 클라스를 확장하고 aboutApplication () 이라는 처리 부를 포함한다 . 기정 About 칸을 펼 
칠 대신에 이 처 리 부를 실 행하여 자기 의 About 칸을 만들고 현시할수 있다 . 

I 참고 : 5 장에서 About 칸을 만드는 실례를 찾을수 있다 . I 


제3절. 튀여나오기차림표 

QPopupMenu 객체를 QMenuBar 에 련결할 필요는 없다 . 차림표를 창문부품의 중심에 펼칠 
수 있다 . 응용프로그람이 할 일은 위치를 지정하고 show () 메쏘드를 호출하는것이다 . 다음 실 
례 는 그림 6-11 과 같이 마우스의 오른쪽단추를 찰칵할 때 튀 여나오기 차림 표를 현시 한다 . 



Activate 

Deactivate 

Arrange 


| Logout_-J 

그림 6-11. 창문부품의 중심에 펼쳐진 차림표 

MenuPopup 머 러 부파 일 

1 /* menupopup.h */ 

2 #ifndef MENUPOPUP_H 

3 #define MENUPOPUP_H 

4 
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5 #include <qpopupmenu.h> 


7 class MenuPopup: public QWidget 

8 { 

9 Q_OBJECT 

10 public: 

11 MenuPopup(QWidget *parent=0,const char *name=0); 

12 protected: 

13 virtual void mousePressEvent(QMouseEvent * event); 

14 private: 

15 QPopupMenu *popup; 

16 private slots: 

17 void slotStub(); 

18}; 

19 

20 #endif 

7 행에서 클라스 MenuPopup 는 기초클라스로서 QWidget 를 사용하고 그것은 창문부품이 
므로 가상보호메쏘드 mousePressEventO 를 계승한다 . 이 함수는 마우스지시자가 창문부품안에 
있는데 마우스단추가 늘릴 때마다 호출된다 . 

MenuPopup 

1 /* menupopup.cpp */ 

2 #include <kapplication.h> 

3 #include "menupopup.h n 

4 

5 int main(int argc, char **argv) 

6 { 

7 KApplication app(argc, argv, "setxy"); 

8 MenuPopup menupopup; 

9 menupopup. sho w(); 

10 app.setMainWidget(&menupopup); 

11 retum(app. exec()); 

12 } 

13 

14 MenuPopup::MenuPopup(QWidget ^parent,const char *name) 

15 : QWidget(parent,name) 
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16 { 

17 setMinimumSize(90,40); 

18 resize(200 ， 100); 

19 

20 popup = new QPopupMenu(this); 

21 popup->insertItem( ,, Activate",this,SLOT(slotStub())); 

22 popup->insertItem( n Deactivate",this,SLOT(slotStub())); 

23 popup->insertItem( M Arrange",this,SLOT(slotStub())); 

24 popup->insertSeparator(); 

25 popup->insertSeparator(); 

26 popup->insertItem( n Logout n ,this,SLOT(slotStub())); 

27} 

28 

29 void MenuPopup :: mousePressEvent(QMouseEvent *event) 

30 { 

31 if(event->button() = RightButton) { 

32 popup->move(x() + event- 〉 x(),y() + event->y()); 

33 popup->exec(); 

34 } 

35} 

36 void MenuPopup :: slotStub() {} 

14 행에서 시작하는 MenuPopup 구성자는 QPopupMenu 객체를 만들고 클라스선언의 15 행 
에서 정의된 popup 에 그 주소를 보관한다 . QPopupMemi 의 부모창문부품은 보통 차림표를 펼 
치는 창문부품이다 .21 〜 26 행은 차림표에 항목들을 삽입한다 . 

29 행의 가상메쏘드 mousePressedEvent() 는 부모 QWidget 클라스의 메쏘드를 재정의한다 . 
이 메쏘드는 마우스단추를 찰칵할 때마다 호출된다 . 31 행은 오른쪽 마우스단추를 선택하였는 
가를 판단한다 . 만일 그렇다면 move() 호출은 차림표위치를 지정하고 exec() 호출은 그것을 펄 
친다 . 32 행에서 move() 호출에 공급된 자리표위치는 부모창문부품과 마우스지시자의 x 와 y 자 
리표들의 합이다 . 결과자리표는 차림표가 직접 마우스아래에 나타나게 하는 화면우의 마우 
스위치이다 . 


제4절. 도구띠 

KMainWindow 는 많은 도구띠 들을 관리 한다 . 기 정 으로 그것 들은 삽입 되 는 순서 로 창문 
의 꼭대기에 현시된다 . 차림표가 있으면 도구띠들은 그 아래에 현시된다 . 그리고 도구띠에는 
단추그림기호들외에 다른것을 가질수 있다 . 다음 실례는 그림 6-12 와 같이 단추 , 분리선，복 
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합칸，그리고 표식자창문부품을 포함하는 2 개 도구띠를 설치한다 . 



그림 6-12. 여러 항목을 포함하는 한쌍의 도구띠 

ToolBarMain 머 리 부파일 

1 /* main.h */ 

2 #ifndef TOOLBARMAIN_H 

3 #defme TOOLBARMAIN_H 

4 

5 #include <kmainwindow.h> 

6 #include <ktoolbar.h> 

7 

8 class ToolBarMain: public KMainWindow 

9{ 

10 Q_OBJECT 

11 public: 

12 ToolBarMain(); 

13 private slots: 

14 void slotExit(); 

15 void slotStub(); 

16 void slotF ont(int index); 

17 bool queryClose(); 

18 private: 

19 void createMainWidget(); 

20 void createT oolBarOne(); 

21 void createToolBarTwo(); 

22 }; 

23 


24 #endif 
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그것은 도구띠들을 관리 하는 KMainWindow 이므로 클라스 ToolBarMain 은 8 행에서 
KMainWindow 의 파생클라스로 선언된다 . 14 〜 16 행에서 정의된 처리부들은 도구띠항목들이 
선택될 때 호출을 받아들인다 . 17 행의 처리부 queryClose() 는 체계가 응용프로그람에 창문을 
담으려고 하는가를 묻는데 사용된다 . 

ToolBarMain 

1 /* toolbarmain.cpp */ 

2 #include <kapplication.h> 

3 #include <qpushbutton.h> 

4 #include <qstrlist.h> 

5 #include <qcstring.h> 

6 #include ’’toolbarmain.h" 

7 

8 int main(int argc, char **argv) 

9{ 

10 KApplication app(argc, argv, "toolbarmain"); 

11 ToolBarMain *toolbarmain = new ToolBarMain(); 

12 toolbarmain->show(); 

13 retum(app. exec()); 

14} 

15 ToolBarMain::ToolBarMain() : KMainWindow() 

16 { 

17 createMainWidget(); 

18 createToolBarOne(); 

19 createToolBarTwo(); 

20 } 

21 void ToolBarMain: : createMainWidget() 

22 { 

23 QPushButton ^button = 

24 new QPushButton("Top Level\nWidget",this); 

25 setCentralWidget(button); 

26} 

27 void ToolBarMain: : createToolBarOne() 

28 { 

29 QPixmap fpix( n flag.png M ); 

30 QPixmap rpix( M redo.png M ); 
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31 QPixmap upix(’’undo.png"); 

32 QPixmap spix("stop.png M ); 

33 QPixmap epix("exit.png"); 

34 

35 KToolBar *toolbar = toolBar(l); 

36 toolbar->insertButton(fpix,5,SIGNAL(clicked()), 

37 this,SLOT(slotStub()),TRUE, "Flag As Used，，); 

38 toolbar->insertButton(rpix,6,SIGNAL(clicked()), 

39 this,SLOT(slotStub()),TRUE, "Redo，，); 

40 toolbar->insertButton(upix,7,SIGNAL(clicked()), 

41 this,SLOT(slotStub()),TRUE, "Undo ")； 

42 toolbar->insertSeparator(); 

43 toolbar->insertButton(spix,7,SIGNAL(clicked()), 

44 this,SLOT(slotStub()),TRUE, "Stop"); 

45 toolbar->insertButton(epix,8,SIGNAL(clicked()), 

46 this,SLOT(slotExit()),TRUE, "Exit Program"); 

47} 

48 void ToolBarMain: : createToolBarTwo() 

49 { 

50 QPixmap fpix( M bottom.png n ); 

51 KToolBar *toolbar = toolBar(2); 

52 toolbar->insertButton(fpix, 10,SIGNAL(clicked()), 

53 this,SLOT(slotStub()),TRUE, M Go To Bottom ")； 

54 

55 toolbar->insertLineSeparator(); 

56 

57 QStrList *list = new QStrList(); 

58 list->insert(0, "Courier"); 

59 list->insert(l, "Times Roman"); 

60 list- 〉 insert(2, "Arial"); 

61 toolbar->insertCombo(list, 11,FALSE, 

62 SIGNAL(activated(int)), 

63 this,SLOT(slotFont(int)), 

64 TRUE, "Select Font",110); 


65 
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66 toolbar->insertSeparator(); 

67 

68 QLabel *label = new QLabel("Any Widget", toolbar); 

69 toolbar->insertWidget( 12,90,label); 

70} 

71 void T oolBarMain: : slotExit() 

72 { 

73 kapp->exit(0); 

74} 

75 bool ToolBarMain: : queryClose() 

76 { 

77 retum(TRUE); 

78} 

79 void ToolBarMain::slotStub() {} 

80 void ToolBarMain :: slotFont(int index) {} 

15 행에서 시작하는 ToolBarMain 구성자는 기본창문용창문부품과 2 개의 도구띠를 만들기 
위하여 메쏘드들을 호출한다 . 21 행에 있는 메쏘드 createMainWidgetO 에서 만들어진 기본창문 
부품은 누름단추이다 . 

한개 도구띠 성 원(우의 도구띠 )은 27 행 에 서 메 쏘드 createToolBar 에 의해 만들어 진 다 . 그 
림 6-12 에 이미 보여준것처럼 이 도구띠의 매개 항목은 자체의 픽스매프를 가지고있다 . 픽스 
매프들은 29 〜 33 행에서 파일들로부터 적재된다 . KToolBar 는 이 클라스가 KMainWindow 로부 
터 물려 받은 메쏘드 toofflarO 를 호출하여 만든다 . 앞에서 설명한 차림 표창문을 만드는 메쏘 
드와 달리 tooffiarO 메 쏘드는 호출시마다 새 도구띠를 만들어서 돌려 준다 . 그리고 그것이 돌 
려주는 도구띠는 이미 현시요소로서 KMainWindow 에 삽입되 였다 . 

도구띠의 3 번째와 4 번째 성원사이에 작은 공간이 있다 . 이 공간은 42 행에서 
insertSeparatorO 호출에 의해 삽입된다 . 더 넓은 공간을 요구한다면 분리선을 더 많이 삽입할 
수 있다 . 

48 행 에 서 메 쏘드 createTooLBarTwo() 에 의 해 창조된 둘째 도구띠 는 더 복잡한 도구띠 단 
추들을 가지 고있 다 . 표준도구띠 단추는 52 행 에 서 insertButton() 호출에 의 해 추가되 고 55 행 에 서 
insertLineSeparatorO 호출에 의해 그 오른쪽에 수직분리선이 삽입된다 . 

문자렬배렬은 58 〜 60 행에서 insertO 호출에 의해 QStrList 객체에 삽입되고 그 배렬은 61 행 
에서 insertCombo() 을 호출함으로써 도구띠의 복합칸을 설치하는데 사용된다 . 내부적으로 
KToolBar 는 목록을 관리하기 위하여 표준 QComboBox 를 창조하므로 insertComboO 에 넘긴 대 
부분의 정보는 QComboBox 에 넘겨진다 . 58 〜 60 행의 insert() 메쏘드들은 복합칸본문을 정의하 
고 매개 본문에 ID 번호를 할당한다 . 61 행의 insertComboO 호출은 목록을 사용되 여 ID 번호 11 
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을 가지는 QComboBox 를 만들며 사용자가 써 넣기 할수 없다는것을 지정 한다 . 신호는 
activated() 이고 처리부는 sloffontO 이며 그것들은 둘다 선택항목의 ID 번호를 처리부메쏘드에 
넘기기 위한 int 인수를 가진다 . TRUE 인수는 QComboBox 가 허용된다는것을 지 정 한다 . 문자렬 
"Select Font” 는 도구암시 의 본문을 지 정 하며 수값 110 은 화소너 비 를 지 정한다 . 

알아두기 : 이 실례의 복합칸은 ID 번호를 가지고 처리부를 호출하지만 대신에 문자렬 
을 사용할수 있다 . 이를 위하여 신호로서 activated(String &), 처리부로서 slotFont(String 
&) 를 사용한다 . 

도구띠 에 어떠 한 창문부품이 든지 설치할수 있다 . 실례로 insertCombo() 를 호출하는것외 
에 QComboBox 를 더 많이 조종하려고 한다면 자체의 복합칸을 만들고 insertWidgetO 를 호출 
하여 그것 을 설 치할수 있 다 . 68 행 과 69 행 의 코드는 표식 자를 만들고 설 치한다 . 표식 자는 다 
른 항목들이 수행하는 방식으로 마우스에 응답하지 않는다 . 창문부품을 설치하고 있을 때 
도구띠는 응답을 얻을 필요가 있는 모든 신호와 처리부들을 설정한다고 가정한다 . 

제5절. 상태띠 

KMainWindow 의 요소로 포함할수 있는 KStatusBar 창문부품이 있다 . 그것은 보통 창문바 
닥에 현시되며 응용프로그람이 본문행을 현시하고 계속 갱신하는데 사용될수 있다 . 그림 
6-13 에 보여주는 다음 실례는 상태띠를 사용하여 한쌍의 단추들에 의해 증가감소되는 내부 
계 수기 의 현재 값을 현 시한다 . 



그림 6-13. 값을 추적하는 상태띠 

StatusBarMain 머 리 부과 일 

1 /* statusbarmain.h */ 

2 #ifndef STATUSBARMAIN_H 

3 #define STATUSBARMAIN_H 

4 

5 #include <kmainwindow.h> 

6 #include <kstatusbar.h> 
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8 class StatusBarMain: public KMainWindow 

9{ 

10 Q_OBJECT 

11 public: 

12 StatusBarMain(); 

13 private: 

14 int counter; 

15 KStatusBar *status; 

16 private slots: 

17 bool queryClose(); 

18 void slotAddOne(); 

19 void slotSubtractOne(); 

20 private: 

21 void createMainWidget(); 

22 void createStatusBar(); 

23}; 

24 

25 #endif 

8 행에서 선언이 시작되는 클라스 StatusBarMain 은 KMainWindow 클라스를 계승하며 이것 
은 KStatusBar 를 계승한다는것을 의미한다 . 추적하는 값은 14 행에서 counter 로 정의되고 호출 
하기 쉽게 KStatusBar 지적자는 15 행에서 정의된 status 에 보관된다 . 

StatusBarMain 

1 /* statusbarmain.cpp */ 

2 #include <kapplication.h> 

3 #include <qpushbutton.h> 

4 #include <kcontainer.h> 

5 #include "statusbarmain.h” 

6 

7 int main(int argc, char **argv) 

8{ 

9 KApplication app(argc, argv, "statusbarmain"); 

10 StatusBarMain *statusbarmain = new StatusBarMain(); 

11 statusbarmain->sho w(); 

12 retum(app. exec()); 

13} 
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14 StatusBarMain: :StatusBarMain() : KMainWindow() 

15 { 

16 counter = 0; 

17 createMainWidget(); 

18 createStatusBar(); 

19} 

20 void StatusBarMain: : createMainWidget() 

21 { 

22 KContainerLayout *layout = 

23 new KContainerLayout(this, "layout"); 

24 layout->setOrientation(KContainerLayout: : V ertical); 

25 

26 QPushButton ^button; 

27 button = new QPushButton("Add One",this); 

28 connect(button,SIGNAL(clicked()), 

29 this,SLOT(slotAddOne())); 

30 layout->packStart(button); 

31 button = new QPushButton("Subtract One",this); 

32 connect(button,SIGNAL(clicked()), 

33 this,SLOT (slotSubtractOne())); 

34 layout->packStart(button); 

35 

36 layout->sizeToFit(); 

37 setCentralWidget(layout); 

38} 

39 void StatusBarMain: : createStatusBar() 

40 { 

41 status = statusBar(); 

42 status->insertItem(QString( n »"), 1); 

43 status->insertItem(QString("Add or Subtract"),2); 
44} 

45 void StatusBarMain: : slotAddOne() 

46 { 

47 status->changeltem( 

48 QStringCTlus 1 = %l”).arg(++counter),2); 
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49 } 

50 void StatusBarMain: : slotSubtractOne() 

51 { 

52 status->changeltem( 

53 QString("Minus 1 * % 1 ").arg(--counter) ， 2) ; 

54} 

55 bool StatusBarMain::queryClose() 

56 { 

57 retum(TRUE); 

58} 

프로그람의 기본함수는 StatusBarMain 객체를 만든다 . 그것은 KMainWindow 를 계승하므 
로 자동적 으로 응용프로그람의 제 일 웃준위창문으로 된 다 . 14 행 에 서 시 작하는 StatusBarMain 구 
성자는 내부계수기값을 0 으로 초기화한 다음 기본창문부품을 만들고 상태띠의 초기본문을 
설치 한다 . 

20 행에서 시작하는 메쏘드 createMainWidget() 는 그림 6-13 에 이미 보여준것처럼 
KContainerLayout 창문부품을 사용하여 2 개 단추를 보유한다 . 하나의 단추는 처리부메쏘드 
slotAddOne () 에 련결되고 다른 단추는 slotSub 仕 actOne () 에 련결된다 . 

상태 띠 자체 는 39 행 의 메 쏘드 createStatusBarO 에 서 초기 화된다 . statusBarO 호출은 상태 띠 의 
실례를 만들고 그 지적자를 돌려준다 . KMainWindow 에 하나의 KStatusBar 만 있을수 있으므로 
statusBarO 에 대한 다음 호출은 갈은 상태띠객체의 주소를 되돌려준다 . 사실상 이 클라스내로 
부터 상태띠를 호출하려고만 한다면 항상 지적자를 얻을수 있으므로 자체로 지적자를 보관 
할 필요는 없다 . 

42 행 과 43 행 은 상태띠 의 insertltemG 을 호출하여 현시 문자렬을 삽입한다 . 문자렬은 두 
부분(더 있을수 있다)에 삽입되고 매개에 ID 번호가 할당된다 . 문자털들은 각각 추가되는 순 
서로 현시되고 그것들을 변경하려고 할 때 ID 번호가 요구된다 . 이리하여 그것들을 모두 바 
꾸지 않고 문자렬부분을 변경한다 . 실례로 45 행의 처리부메쏘드 slotAddOneO 는 "Add " 단추가 
선택될 때마다 호출되여 계수기를 증가시키며 ID 번호 2 를 가지는 상태띠본문은 changeltem() 
호출에 의해 교체된다 . ID 번호 1 을 가지는 본문은 바뀌지 않는다 . 마찬가지로 ’’Subtract ’’ 단추 
는 50 행 에 서 slotSubtractOne () 을 실 행 하여 계 수기 를 감소시 키 며 ID 번 호 2 의 본문만 변경 한다 . 
알아두기 : 一 QString 클라스의一 arg() 메쏘드가一문자렬 들을一여러가지一자료형들로 
형식화하는데 사용된다 . 모든 자료형과 형식선택의 실례는 편의클라스들을 설명하는 
16 장에 서 설 명한다 . 

요구된다면 많은 본문구획(또는 본문항목)들로 현시문자렬을 분리하고 매개 문자렬과 
개별적으로 작업할수 있다 . 또한 KStatusBar 메쏘드 clear () 를 호출하여 모든 ID 번호들로부터 본 
문을 삭제할수 있다 . 
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요 약 

KMainWindow 클라스는 응용프로그람의 기능호출을 사용자에게 제공하는데 쓰이는코드 
를 포함하는 특수한 제 일웃준위창문이 며 사용자가 응용프로그람의 현재상태 를 계 속 알수 있 
게 한다 . 

• 차림 표띠 는 제 일웃준위창문의 꼭대 기 나 바닥에 현시 될수 있다 . 사용자의 요구에 따라 
그것은 제일웃준위창문에서 떼내여 화면에 독립적인 존재로서 표시할수 있다 . 

• 어떠한 창문이든지 마우스나 건반의 조종하에 펼쳐지는 차림표를 가질수 있다 . 이 차 
림표로부터의 선택 또는 다른 위치 에서 마우스찰칵은 펼쳐 진 차림표를 지워버린다 . 

•많은 도구띠들은 제일웃준위창문의 4 개 측면의 어디에나 개별적으로 위치할수 있으 
며 또는 개개를 분리하여 화면에서 독립 적 인 항목으로서 현시할수 있다 . 

•상태띠는 항상 갱신된 본문을 가지며 제일웃준위창문의 바닥에 현시되게 만들어진다 . 

7 장은 임의의 순간에 오직 하나만 선택할수 있는 라지오단추그룹과 같이 서로 련관된 
집합을 만들고 현시하는데 쓰이는 창문부품들과 목록으로부터 하나이상의 항목들을 사용자 
가 선 택 하는데 쓰이 는 복합칸을 설명한다 . 
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제 7 장 . 창문부품그룹 


학습내용 

하나의 처리부에 의해 동작하도록 일련의 단추들을 조직하는 방법 
라지오단추들을 련동시키는 방법 
검사단추들을 련결하는 방법 
틀을 창문부품에 구축하는 방법 
자기 창문부품들을 틀로 장식하는 방법 

분리띠들을 이동하여 여 러 창문부품들의 크기를 변경하는 방법 
이 장은 창문이 자주 배치될 때 흔히 제기되는 문제들을 해결하는데 사용할수 있는 몇 
가지 창문부품과 용기들을 시험한다. 실례로 여러개의 단추들을 가진 하나의 창문부품을 만 
들고 이 단추들을 모두 갈은 처리부에 련결할수 있다. 라지오단추들중 하나의 선택은 그룹 
안의 다른 라지오단추의 선택을 해제하므로 그것들을 서로 련동시켜야 한다. 가끔 창문부품 
그룹은 그것들이 수행하는 기능에 따라 련결되며 그것들을 둘러싸는 틀을 그리여 사용자에 
게 보여주는 방법이 있다. 


제 1 절 . KButtonBox 

대화칸창문의 아래에 단추들을 배치하는것은 아주 례사로운 일이다. 클라스 KButtonBox 
는 단추들의 위 치를 지 정하는 일을 간단화하는 용기창문부품이 다. 다음 실례는 KButtonBox 
를 사용하여 수평으로 배렬된 3개 단추를 관리한다. 

1 /* hbuttonbox.cpp */ 

2 #include <kapplication.h> 

3 #include <kbuttonbox.h> 

4 

5 int main(int argc, char **argv) 

6 { 

7 QPushButton ^button 1; 

8 QPushButton *button2; 

9 QPushButton *button3; 

10 KApplication app(argc, argv, "vbuttonbox"); 

11 

12 KButtonBox *box = 

13 new KButtonBox(0 ? KButtonBox: : HORIZONTAL,25,15); 

14 button 1 = box->addButton( M First Button'*); 
button2 = box->addButton("Second Button"); 


15 
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16 button 3 = box -> addButton("Third Button "); 

17 box -> layout (); 

18 box -> show (); 

19 box -> resize ( 10,10); 

20 

21 app . setMain Widget ( box ); 

22 retum ( app . exec ()); 

23} 

단추칸은 12 행과 13 행에서 만들어진다. 첫 인수는 보통 부모창문부품의 주소이지만 실 
례에서는 그것을 제 일웃준위창문으로 사용하므로 부모가 없다. 둘째 인수는 단추들의 방향 
즉 HORIZONTAL 또는 VERTICAL 을 지 정 한다. 마지 막 2개 인수는 단추들의 주위 에 삽입 하 
는 최 소공간을 지 정한다. 첫째 인수는 매 개 단추와 KButtonBox 의 경 계 사이 의 최 소화소거리 
를 지 정한다. 둘째 인수는 단추들사이 의 화소거리 를 지 정한다. 결과는 그림 7-1 에 보여 준 단 
추들의 행이다. 



그림 7-1. KButtonBox 에 포함된 3개 의 단추 

14〜16행에서 addButtonO 호출은 단추들을 만든다. 즉 KButtonBox 는 매개 단추를 만들고 
그것의 지적자를 돌려준다. 실례를 간단하게 만들기 위하여，단추들을 처리부에 련결하지 않 
는다. 17행의 layout () 호출은 그밖에 아무것도 추가하려고 하지 않다는것과 나아가서 자체의 
환경을 구성한다는것을 KButtonBox 에게 알리기 위하여 필요하다. 18행과 19행은 임의의 다른 
창문부품에서나 동일하며 KButtonBox 는 그 자체(그리고 그것의 모든 내용)를 현시하게 하고 
그 최소높이와 최소너비로 크기가 설정된다. 

그림 7-1 의 단추들은 모두 크기가 같다. 포함하는 본문의 길이에 따라 단추너비를 변경 
하려고 한다면 addButton () 메쏘드에 둘째 인수로서 true 를 지 정 할수 있다. 실례로 다음 코드는 
단추들이 담고있는 본문에 따라서 너비가 달라지도록 한다. 
buttonl = box -> addButton("First Button ", TRUE ); 
button 2 = box -> addButton (" Second Button M , TRUE ); 
button 3 = box -> addButton("Third Button ", TRUE ); 

둘째인 수를 FALSE (기정)로 하면 KButtonBox 는 가장 넓은 단추의 크기를 결정하고 다른 
것들의 크기는 그것과 일치하게 조절한다. 드문히 KButtonBox 의 너비를 그것을 담고있는 대 
화칸의 너 비와 정확히 일치시킴으로써 그것 이 자체를 변경시키는 방법과 위 치를 지정할수 
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있다. 그림 7-2 의 꼭대기에 있는 배치는 단추들이 모두 왼쪽에 놓여있는 기정변화를 보여준 
다. 그림의 바닥에 있는 배치는 가변점을 지정한 경우를 보여준다. 




그림 7-2. 변경이 정의된 경우와 안된 경우의 KButtonBox 
그러기 위하여 다음과 같이 두 단추들사이에 가변점을 삽입한다. 
buttonl = box -> addButton("First Button "); 
button 2 = box -> addButton("Second Button '*); 
box -> addStretch ( 1) 

button 3 = box -> addButton("Third Button "); 

신축은 3 장에서 론의된 용기들에서처럼 수행된다. 즉 필요한만큼 가변점들을 추가할수 있 
고 매개는 다른것들에 비례하여 변경되며 비례는 addStretchO 의 인수값에 의해 결정된다. 

조금 변경하면 이전 실례는 수직방향으로 변환될수 있다. 즉 구성자의 둘째 인수를 
VERTICAL 로 변경한다. 

KButtonBox *box = new KButtonBox (0, KButtonBox : : VERTICAL ,25,15); 

결과창문을 그림 7-3 에 보여준다. 변두리로부터 그리고 단추들을 서로 분리하는 공간은 
같은 방법으로 지정된다. 창문이 수직으로 변화될 때 KButtonBox 는 바닥 또는 변화를 지정 
하는 위치 에 공간을 삽입한다. 



그림 7-3. 수직방향을 가지는 KButtonBox 

















제 2 절. 하나의 처리부를 가지는 단추그룹 

QButtonGroup 객체는 수평 또는 수직으로 단추그룹을 배렬하는데 사용될수 있다. 그룹에 
추가된 매개 단추에는 ID 번호가 할당되고 필요하다면 모든 단추들에 대하여 하나의 처리부 
메쏘드를 사용할수 있다. 직접 QButtonGroup 을 창조할수 있지만 단추들을 수평으로 배렬하 
는가 수직으로 배렬하는가에 따라 QHButtonGroup 이 나 QVButtonGroup 을 사용하는것 이 더 간 
단하다. 또한 QButtonGroup 은 QFrame 이므로 QFrame 메쏘드호출을 사용하여 그룹의 모양을 
바꿀수 있다. 

다음 실례는 수평 QButtonGroup 내에 4개 단추를 가진다. 그림 7-4 에 보여준것처럼 단추 
들의 행아래 에는 매개 단추를 누를 때마다 본문이 갱신되 는 표식 자가 있다. 



그림 7-4. 단추들을 수평으로 배 렬하는 QHButtonGroup 창문부품 
HorizPush 머리 부파일 

1 /* horizpush.h */ 

2 #ifndef HORIZPUSH_H 

3 #defme HORIZPUSH_H 

4 

5 #include < qwidget . h > 

6 #include < qlabel . h > 

7 

8 class HorizPush : public QWidget 

9{ 

10 Q_OBJECT 

11 public : 

12 HorizPush(QWidget * parent =0 ,const char * name =0); 

13 private : 

14 QLabel * label ; 

15 enum ButtonChoice { SetColor , Configure , Clear , Exit }; 

16 private slots : 

17 void slotButton(int ID ); 

18}; 
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19 

20 #endif 

14 행에서 선언된 표식자는 창문의 바닥에 본문을 현시한다 . 15 행의 렬거선언은 매개 단 
추에 련결된 ID 번호로서 사용되므로 처리부메 쏘드는 어느 단추를 눌렀는가 결정할수 있다 . 
HorizPush 

1 /* horizpush.cpp */ 

2 #include <kapplication.h> 

3 #include <qlayout.h> 

4 #include <qhbuttongroup.h> 

5 #include <qpushbutton.h> 

6 #include "horizpush.h" 

7 

8 int main(int argc, char **argv) 

9{ 

10 KApplication app(argc, argv, "horizpush"); 

11 HorizPush *horizpush = new HorizPush(); 

12 horizpush->show(); 

13 app.setMainWidget(horizpush); 

14 retum(app. exec()); 

15} 

16 

17 HorizPush: : HorizPush(QWidget ^parent,const char *name) 

18 : QWidget(parent,name) 

19 { 

20 QPushButton ^button; 

21 QVBoxLayout *layout = new QVBoxLayout(this,5); 

22 

23 QHButtonGroup *group = new QHButtonGroup(this, ’’hgl’’); 

24 button = new QPushButton("Set Color",group); 

25 group->insert(button,SetColor); 

26 button = new QPushButton("Configure",group); 

27 group->insert(button,Configure); 

28 button = new QPushButton("Clear",group); 

29 group->insert(button,Clear); 
button = new QPushButton("Exit",group); 


30 
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31 group->insert(button,Exit); 

32 connect(group,SIGNAL(clicked(int)), 

33 this,SLOT(slotButton(int))); 

34 layout->addWidget(group); 

35 

36 label = new QLabel(" ",this); 

37 layout->addWidget(label); 

38 

39 resize(10,10); 

40 layout->activate(); 

41} 

42 void HorizPush::slotButton(int ID) 

43 { 

44 switch(ID) { 

45 case SetColor: 

46 label->setText("Set Color button pressed' 1 ); 

47 break; 

48 case Configure: 

49 label->setText("Configure button pressed"); 

50 break; 

51 case Clear: 

52 label->setText(""); 

53 break; 

54 case Exit: 

55 kapp->exit(0); 

56 } 

57} 

17 행에서 시작하는 구성자는 창문배치를 만든다 . 기본배치관리기는 21 행에서 만들어지 
는 수직 칸이 고 2 개 창문부품 즉 우에 QHButtonGroup, 아래 에 QLabel 을 포함한다 . 

QHButtonGroup 은 23 행에서 HorizPush 객체를 부모창문부품으로 하여 만들어지므로 
QVBoxLayout 객체가 용기로서 작용한다 할지라도 창문부품이 아니다 . HorizPush 객체는 
QWidget 를 계승하므로 다른 창문부품의 부모로서 쓰일수 있다 . 

24 〜 31 행 은 4 개 누름단추를 만들어 서 QHButtonGroup 에 삽입한다 . QHButtonGroup 도 창 
문부품이므로 누름단추창문부품들의 부모로서 쓰일수 있다 . insertO 호출은 매개 단추를 그룹 
에 삽입할 때 ID 번호를 할당한다 . 正)번호를 지 정 하지 않으면 첫째 단추는 기 정 으로 0, 둘째 
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는 1, …으로 된다 . 그러나 正)번호는 단추들을 식별하는 유일한 방법이므로 그것들을 자기가 
지정하는것이 좋다 . 이 실례에서 값들을 렬거형값으로 정의하여 단추들을 추가삭제하는 일 
을 편리하게 한다 . 

32 행에서 connect () 호출은 QHButtonGroup 의 checked () 신호를 국부처리부 slotButton () 에 련 
결 한다 . 34 행 에서 QHButtonGroup 은 수직 칸의 꼭대 기 에 삽입 된다 . 36 행 과 37 행 에서 수직 칸의 
바닥에 표식자를 만들어서 보관한다 . 

내부적으로 QHButtonGroup 은 매개 단추로부터 clickedO 신호를 받아들이는 처리부를 가 
지고 있으며 자기의 clickedO 신호를 발생하여 단추에 할당된 ID 번호를 전한다 . 42 행에서 
slofflutton () 처리부는 신호를 받아들이고 正)번호를 러용하여 어떤 작용이 취해졌는가를 판단 
한다 . 正)가 SetColor 또는 Configure 이면 본문이 설정된다 . ID 가 Clear 이면 본문은 지워진다 . 
Exit 값은 프로그람을 완료한다 . 

QHButtonGroup 창문부품은 단추들을 수평으로 현시 하는데 쓰이고 QVButtonGroup 은 수 
직으로 현시하는데 쓰인다 . 필요한 과정은 수평그룹을 만드는 과정과 꼭같다 . 그림 7-5 에 보 
여주는 창문을 현시 하도록 이 전 실례를 변경 하기 위하여 수평단추그롭대신에 수직단추그룹 
을 포함하여 4 행 을 변 경한다 . 

#include <qhbuttongroup.h> 

그다음 23 행 을 변 경 하여 수평 단추그룹대 신 에 수직단추그룹을 다음과 같이 만든다 . 

QVButtonGroup *group = new QVButtonGroup (this, "vgl"); 



Configure button pressed 


그림 7-5. 수직으로 단추들을 배 렬하는 QVButtonGroup 창문부품 

제3절. 라지오단추그룹만들기 

QVButtonGroup 은 라지오단추들의 수직렬사이의 관계를 조종하는데 쓰이고 
QHButtonGroup 은 수평행 을 조종하는데 쓰인다 . QRadioButton 을 QButtonGroup 에 삽입할 때 마 
다 한개 단추를 선택할 때와 같은 방법으로 다른 단추들과 련결된다 . 그림 7-6 에 보여준 창 
문은 다음 실례에 의해 생성된다 . 
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그림 7-6. 라지오단추들의 모임을 조종하는 QVButtonGroup 창문부품 
VertRadio 머 리 부파일 

1 /* vertradio.h */ 

2 #ifndef VERTRADIO_H 

3 #defme VERTRADIO_H 

4 

5 #include <qwidget.h> 

6 #include <qlabel.h> 

7 

8 class VertRadio: public QWidget 

9{ 

10 Q_OBJECT 

11 public: 

12 VertRadio(QWidget *parent=0,const char *name=0); 

13 private: 

14 QLabel *label; 

15 enum ButtonChoice { Total, Average, 

16 Maximum, Minimum, Exit }; 

17 private slots: 

18 void slotButton(int ID); 

19}; 

20 

21 #endif 

매개 단추는 유일식별번호를 가지며 15 행에서 선언된 렬거 ButtonChoice 값은 자기 프로 
그람이 이름에 의해 매개 번호를 참고할수 있게 한다 . 

VertRadio 
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1 /* vertradio.cpp */ 

2 #include <kapplication.h> 

3 #include <qlayout.h> 

4 #include <qvbuttongroup.h> 

5 #include <qradiobutton.h> 

6 #include <qpushbutton.h> 

7 #include "vertradio.h" 

8 

9 int main(int argc, char **argv) 

10 { 

11 KApplication app(argc, argv, ’’vertradio’’); 

12 VertRadio *vertradio = new VertRadio(); 

13 vertradio->show(); 

14 app. setMainW idget(vertradio); 

15 retum(app. exec()); 

16} 

17 

18 VertRadio: : VertRadio(QWidget *parent,const char *name) 

19 : QWidget(parent,name) 

20 { 

21 QRadioButton *button; 

22 QVBoxLayout *layout = new QVBoxLayout(this,5); 

23 

24 QVButtonGroup *group = new QVButtonGroup(this, "vgl"); 

25 button = new QRadioButton(’Total",group); 

26 group->insert(button,T otal); 

27 button = new QRadioButton("Average n ,group); 

28 group->insert(button,Average); 

29 button = new QRadioButton( "Maximum",group); 

30 group->insert(button,Maximum); 

31 button = new QRadioButton("Minimum",group); 

32 group->insert(button,Minimum); 

33 QPushButton *pButton = new QPushButton("Exit",group); 

34 group->insert(pButton,Exit); 

35 connect(group,SIGNAL(clicked(int)), 
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36 this,SLOT(slotButton(int))); 

37 layout->addWidget(group); 

38 

39 label = new QLabel(" " ， this); 

40 layout->addWidget(label); 

41 

42 resize(10 ， 10); 

43 layout->activate(); 

44} 

45 void VertRadio :: slotButton(int ID) 

46 { 

47 switch(ID) { 

48 case Total: 

49 label->setText("Total"); 

50 break; 

51 case Average: 

52 label->setText( M Average n ); 

53 break; 

54 case Maximum: 

55 label->setText("Maximum M ); 

56 break; 

57 case Minimum: 

58 label->setText( n Minimum"); 

59 break; 

60 case Exit: 

61 kapp->exit(0); 

62 } 

63} 

이 실례는 VertRadio 객체 를 만들어서 제 일웃준위창문의 창문부품으로 사용한다 . 18 행 에 
서 시작하는 구성자는 QVBoxLayout 를 사용하여 아래에 표식 자를 가지는 단추들의 목록을 
포함한다 . 표식자는 어느 단추가 능동으로 되는가를 알리는데 사용된다 . 

24 〜 32 행 은 4 개 라지 오단추를 만들어 서 QVButtonGroup 에 삽입한다 . 표준 QPushButton 은 
33 행에서 만들어지고 34 행에서 같은 QVButtonGroup 창문부품에 설치된다 . 단추들을 만들 때 
QVButtonGroup 를 부모창문부품으로 사용한다 . QButtonGroup 의 모든 라지 오단추들은 자동적 
으로 련동되므로 한번에 하나씩 선택된다 . QVButtonGroup 는 오직 라지오단추들만 련동시키 
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고 다른 종류의 단추들은 독자적인 실체로 남아있으므로 그룹에 여러가지 형의 단추들을 섞 
을수 있다 . 

45 행에서 정의된 처리부메쏘드 slotButton() 은 모든 단추들에 대하여 호출되며 그것들의 
형에는 관계없다 . 단추의 ID 값을 검사한 후 처리부메쏘드는 현재 어느 라지오단추가 선택되 
였는가를 가리키도록 표식 자본문을 설정한다 . 비 라지 오단추는 프로그람을 완료하는데 사용 
될수 있다 . 

라지 오단추들을 수직으로 배 렬하는것 이 관례 이지만 만약 그것들을 수평으로 배 렬해 야 
한다면 간단히 수행할수 있다 . 이 전 실례를 수평 방향으로 바문 결과를 그림 7-7 에 보여준다 . 
그러기 위하여 5 행을 다음과 같이 변환한다 . 

#include <qhbuttongroup.h> 

그리고 24 행을 수평그룹칸의 창조로 변환한다 . 

QHButtonGroup *group = new QHButtonGroup(this, "hgl") ; 



그림 7-7. 수평으로 배렬된 라지오단추그룹 

제4절. 검사단추그룹만들기 

QCheckBox 는 off 와 on 상태를 절환할수 있는 단추이다 . 상태는 QCheckBox 자체 에 보관된 
다 . 검사단추는 가끔 절환단추라고 부른다 . 다음 실례는 그림 7-8 에 보여주는 검사단추들의 
그룹을 만든다 . 검사표식자는 검사단추가 on 상태로 되여야만 나타난다 . 




X]ifotai] 

□ Average 

[: Maximum 

□ Minimum 



Exit 





Tot 


그림 7-8. 수직으로 배렬된 QCheckBox 단추그룹 

VertCheck 머 리 부파일 
1 /* vertcheck.h */ 
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2 #ifndef VERTCHECK_H 

3 #define VERTCHECK_H 

4 

5 #include <qwidget.h> 

6 #include <qlabel.h> 

7 #include <qvbuttongroup.h> 

8 

9 class VertCheck: public QWidget 

10 { 

11 Q_OBJECT 

12 public: 

13 VertCheck(QWidget *parent=0,const char *name=0); 

14 private: 

15 QVButtonGroup * group; 

16 QLabel *label; 

17 enum ButtonChoice { Total, Average, 

18 Maximum, Minimum, Exit }; 

19 bool totalFlag; 

20 bool averageFlag; 

21 bool minimumFlag; 

22 bool maximumFlag; 

23 private slots: 

24 void slotButton(int ID); 

25}; 

26 

27 #endif 

QVButtonGroup 은 15 행에서 클라스의 자료성원으로 포함된다 . 그것은 단추정보를 받아 
들이는 처리부가 검사단추상태를 group 으로부터 얻는데 필요한 단추 ID 번호를 공급하기때문 
이다 . 현재 QCheckButton 의 상태설정값은 19 〜 22 행에서 선언된 Boolean 변수들에 보관된다 . 
VertCheck 

1 /* vertcheck.cpp */ 

2 #include <kapplication.h> 

3 #include <qlayout.h> 

4 #include <qcheckbox.h> 

5 #include <qpushbutton.h> 
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6 #include "vertcheck.h” 


8 int main(int argc, char **argv) 

9{ 

10 KApplication app(argc, argv, M vertcheck M ); 

11 VertCheck *vertcheck = new VertCheck(); 

12 vertcheck->show(); 

13 app. setMainW idget( vertcheck); 

14 retum(app. exec()); 

15} 

16 

17 VertCheck: : VertCheck(QWidget *parent,const char *name) 

18 : QWidget(parent,name) 

19 { 

20 QCheckBox ^button; 

21 QVBoxLayout *layout = new QVBoxLayout(this,5); 

22 

23 group = new QVButtonGroup(this, "vgl"); 

24 button = new QCheckBox("Total’’,group); 

25 group->insert(button,T otal); 

26 button = new QCheckBox( n Average",group); 

27 group->insert(button,Average); 

28 button = new QCheckBox( n Maximum n ,group); 

29 group->insert(button,Maximum); 

30 button = new QCheckBox( n Minimum",group); 

31 group->insert(button,Minimum); 

32 QPushButton *pButton = new QPushButton("Exit",group); 

33 group->insert(pButton,Exit); 

34 connect(group,SIGNAL(clicked(int)), 

35 this,SLOT(slotButton(int))); 

36 layout->addWidget(group); 

37 

38 label = new QLabel(" M ,this); 

39 layout->addWidget(label); 

40 
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41 totalFlag = FALSE; 

42 averageFlag = FALSE; 

43 minimumFlag = FALSE; 

44 maximumFlag = FALSE; 

45 

46 resize(10,10); 

47 layout->activate(); 

48} 

49 void VertCheck: : slotButton(int ID) 

50 { 

51 QButton ^button = group->find(ID); 

52 switch(ID) { 

53 case Total: 

54 totalFlag = ((QCheckBox *)button)->isChecked(); 

55 break; 

56 case Average: 

57 averageFlag = ((QCheckBox *)button)->isChecked(); 

58 break; 

59 case Maximum: 

60 maximumFlag = ((QCheckBox *)button)->isChecked(); 

61 break; 

62 case Minimum: 

63 minimumFlag = ((QCheckBox *)button)->isChecked(); 

64 break; 

65 case Exit: 

66 kapp->exit(0); 

67 } 

68 QString string; 

69 if(totalFlag) 

70 string += QString("Tot 

71 if(averageFlag) 

72 string += QString("Avg "); 

73 if(maximumFlag) 

74 string += QString("Max ")； 

75 if(minimumFlag) 
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76 string += QString("Min "); 

77 label->setText(string); 

78} 

17 행 에 서 시 작하는 VertCheck 구성 자는 수직 칸용기 를 만들고 그 꼭대 기 창문부품으로서 
QVButtonGroup, 바닥창문부품으로서 QLabel 을 설 치한다 . QVButtonGroup 의 주소는 클라스에 
서 group 에 보관된다 . addWidget() 호출은 QVButtonGroup 을 QVBoxLayout 배치 관리 기의 꼭대기 
창문부품으로 만든다 . 

24 〜 31 행 은 4 개 QCheckBox 객 체 를 창조하여 QVButtonGroup 에 삽입한다 . 32 〜 35 행 에 서 5 
번째 로 표준누름단추를 만들어 group 에 삽입한다 . 38 행 과 39 행 에서 창문바닥에 본문을 현시 
하는데 사용할 표식 자를 만들고 layout 에 설 치한다 . 

QCheckBox 의 기정조건은 off 이고 이것은 FALSE 를 표시하므로 41 〜 44 행은 4 개 내부기 
발을 검사칸과 갈은 값으로 설정하는데 사용된다 . 하나이상의 검사칸을 초기에 on 으로 미리 
설치하려고 한다면 다음과 같이 할수 있다 . 

button->setChecked(TRUE) ; 

그다음 그것의 대응하는 Boolean 값을 TRUE 로 설정한다 . 다음 절 에서 설명 하는것처 럼 
둘이상의 상태가 검사칸에서 가능하다 . 

49 행의 처리부메쏘드 slotButton() 은 검사단추들중 하나가 절환될 때마다 호출된다 . 활성 
화된 단추의 ID 값은 인수로 제공되며 이 메쏘드는 검사단추의 내부상태를 결정하는데 필요 
하므로 51 행에서 findO 호출은 검사칸자체의 주소를 엄는데 사용된다 . 52 행의 switch 문은 어느 
단추를 선택하였는가 결정하는데 사용된다 . 단추가 검사칸이라면 isCheckedO 호출은 단추가 
on 이면 TRUE 를 , off 이면 FALSE 를 돌려준다 . 국부 Boolean 변수에 검사칸상태를 보관함으로써 
프로그람이 모든 단추들의 상태를 빨리 호출하게 한다 . 

ID 값이 그것 이 Exit 단추라는것을 가리킨다면 65 행의 case 문이 실행되 여 exit() 호출이 응 
용프로그람을 중지하게 한다 . 

68 〜 77 행은 어느 절 환단추가 현재 on 인가를 지정 하는 문자렬을 만들고 문자렬을 초기 
에 그림 7-8 에 보여 준 창문바닥에 현시 된 표식 자본문으로 설 정한다 . 

대체로 절환단추그룹은 수직으로 배렬되지만 수평으로 배렬하려는 경우가 있다 . 이전 
실례는 7 행의 vertcheck.h 를 다음과 같이 변경하여 그림 7-9 과 같이 수평으로 구성할수 있다 . 

#include <qhbuttongroup.h> 

또한 15 행의 vertcheck 上를 다음과 같이 변경한다 . 

QHButtonGroup * group; 

또한 23 행 의 vertcheck.cpp 를 다음과 같이 변경한다 . 

group = QHButtonGroup(this, ’’hgl’’); 
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그림 7-9. 수평으로 배렬된 QCheckBox 단추그룹 

제5절. 틀로서 창문부품 

만약 창문부품집합을 틀이나 칸에 포함하여 창문부품들을 련결하고 하나의 단위로서 
동작하게 하거 나 같은 창문안의 다른 창문부품들과 분리해 야 한다면 QFrame 창문부품은 그 
것 들을 한개 칸에 포함시키 는데 사용될 수 있다 . QFrame 의 바깥에 어 떤 창문부품도 남지 않 
을 때에도 틀의 장식은 창문의 전체 모양을 개량할수 있다 . 

계승나무에서 QFrame 의 직계기초클라스는 QWidget 이다 . 이것은 자기가 만드는 창문부 
품의 기 초클라스를 QWidget 가 아니 라 QFrame 로 하여 가능하다는것을 의 미한다 . 그리 고 현 
존 창문부품들의 대부분은 이려한 방법으로 이미 만드느것이다 . 실례로 QLabel 창문부품은 
QFrame 를 기초클라스들로 사용하지만 기정으로 장식을 허용하지 않고 표식자에 틀을 추가 
하는것은 간단히 형과 크기를 지정하는 문제이다 . 다음 실례는 그림 7-10 과 같이 틀을 허용 
하는 4 개 의 표식 자를 보여 주는 창문을 현시한다 . 



그림 7-10. 틀을 가진 4 개의 표식자들 


LabelFrame 

1 /* labelframe.cpp */ 

2 #include <qlayout.h> 

3 #include <qframe.h> 

4 #include <kapplication.h> 

5 #include <qlabel.h> 
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6 #include “labelframe.h” 


8 int main(int argc, char **argv) 

9{ 

10 KApplication app(argc, argv, ’’labelframe"); 

11 LabelFrame *labelframe = new LabelFrame(); 

12 labelframe->show(); 

13 app.setMainWidget(labelframe); 

14 retum(app. exec()); 

15} 

16 

17 LabelFrame::LabelFrame(QWidget *parent,const char *name) 

18 : QWidget(parent,name) 

19 { 

20 QLabel *lab; 

21 QVBoxLayout *layout = new QVBoxLayout(this,8); 

22 

23 lab = new QLabel("QFrame::Box M ,this); 

24 lab->setFrameStyle(QFrame :: Box | QFrame :: Sunken); 

25 lab->setLineWidth(2); 

26 lab->setMidLineWidth(l); 

27 lab->setAlignment(AlignVCenter | AlignHCenter); 

28 lab->setMargin(8); 

29 layout->addWidget(lab); 

30 

31 lab = new QLabel(’’QFrame: :Box",this); 

32 lab->setFrameStyle(QFrame::Box | QFrame::Raised); 

33 lab->setLineWidth(l); 

34 lab->setMidLineWidth(l); 

35 lab->setAlignment(AlignVCenter | AlignHCenter); 

36 lab->setMargin(8); 

37 layout->addWidget(lab); 

38 


39 lab = new QLabel( M QFrame :: WinPanel n ,this); 

40 lab->setFrameStyle(QFrame::WinPanel | QFrame::Raised); 







41 lab->setAlignment(AlignVCenter | AlignHCenter); 

42 lab->setMargin(8); 

43 layout->addWidget(lab); 

44 

45 lab = new QLabel("QFrame: :Panel",this); 

46 lab->setFrameStyle(QFrame: : Panel | QFrame :: Sunken); 

47 lab->setAlignment(AlignVCenter | AlignHCenter); 

48 lab->setLineWidth(4); 

49 lab->setMargin(8); 

50 layout->addWidget(lab); 

51 

52 resize(10,10); 

53 layout->activate(); 

54} 

17 행에서 시작하는 구성자는 수직칸배치관리기를 만들고 4 개의 표식자를 거기에 포함 

한다. 

23 〜 29 행은 Sunken 그림자와 Box 형태를 결합하여 표식자를 만든다. 결과패턴은 마치도 
직 4 각형의 테두리를 표면에 새겨넣은것처럼 만들어진다. 25 행의 lineWidth() 메쏘드는 중심에 
오목 들어 간 곬을 만드는 두 선분의 매 개 화소너 비 를 지 정 한다. 26 행 의 setMidLine() 메 쏘드는 
선의 중심에 있는 끓의 너비를 지정한다. 27 행과 28 행에서 setAlignmentO 와 setMarginO 호출은 
본문을 중심 에 배치하고 본문과 틀사이 에 8화소경계를 준다. 

31 〜 37 행은 Raised 그림자와 Box 형태를 가지는 다른 표식자를 만든다. 이것은 마치도직 4 
각형의 테두리가 표면에 솟아나게 한다. 

이 틀에 그려지는 선들은 33 행에서 se 仕 ineWidth() 호출이 마루의 경계들이 1 화소너비라 
는것을 지정하므로 앞의것보다 너비가 좁다. 

39 〜 43 행은 직 4 각형이 솟아나오는 WinPanel 형식의 표식자를 만든다. 너비는 기정값으로 
설정되고 곬이나 마루가 없으므로 중간선의 너비는 없다. 

45 〜 50 행은 Panel 형식의 표식자를 만든다. 그것은 표식자전체가 표면아래로 가라앉는것 
처럼 보인다. 직 4 각형 테두리에 그려지는 선은 48 행에서 se 仕 ineWidth() 호출에 의해 4 화소너 
비로 된다. 

Qt 와 KDE 의 대다수 창문부품들은 기초클라스들로서 QFrame 를 사용한다. 그 일부는 기 
정 으로 틀을 현시 하지 만 그것 들은 모두 틀을 현시할 능력 이 있다. 다음 창문부품들중 임 의 
의 것에서 메쏘드 setFrameStyleO 호출은 틀이 나타나게 한다. 

KAboutContainer KMenuBar QHButtonGroup 

KAboutContributor KMultiLineEdit QHGroupBox 
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KAccelMenu 

KApplicationTree 

KBackgroundDockWidget 

KCharSelect 


KCharSelectTable 

KColorCells 

KColorPatch 

KDMView 

KDatePicker 

KDateTable 

KDesktop 

KDockWindow 

KEdit 

KEyesWidget 

KFileSimpleView 

KFormulaToolBar 

KGroupBox 

KHTMLWidget 

KIOListView 

KIconLoaderCanvas 

KIconStyle 

KImageTrackLabel 

KIntSpinBox 


KMultiWallpaperList 

KPopupMenu 

KProgress 

KRuler 

KSeparator 

KSplitList 

KStatusBar 

KStatusBarLabel 

KTabListBoxTable 

KTextBrowser 

KThemeListBox 

KToolBar 

KURLLabel 

KfindWindow 

KiKbdButton 

KiKbdMapInfoWidget 

KickerClientMenu 

QButtonGroup 

QCanvasView 

QFileListBox 

QFileListView 

QGrid 

QGroupBox 

QHBox 


QlconView 

QlconView 

QLCDNumber 

QLabel 

QListBox 

QListView 

QMenuBar 

QMultiLineEdit 

QPopupFrame 

QPopupMenu 

QProgressBar 

QScrollView 

QSpinBox 

QSplitter 

QTableView 

QTextBrowser 

QTextEdit 

QTextView 

QVBox 

QVButtonGroup 

QVGroupBox 

QWellArray 

QWidgetStack 


제 6 절. 틀믈 만들기 위한 선택들 

틀의 형 태를 지 정하는데 많은 환경설정값들을 사용할수 있다 . 즉 Box, Panel, WinPanel, 
Hline 혹은 Vline 이 다 . 또한 매개 형식은 솟아오르고 움푹 폐 여들어가고 또는 평 평한것처 럼 
보이도록 설정될수 있다 . 그리고 선의 너비를 지정할수 있다 . 다음 실례는 틀을 구성하는 각 
이한 방법을 보여준다 . 

1. Box QFrame 

boxframe 이라는 프로그람은 Box 형의 각이한 형태를 보여준다 . 3 가지 가능한 조절은 선너 
비，중간선너 비 그리고 형 래가 솟아오르는가 , 움푹 폐 이는가 , 평 평한가 하는것 이 다 . 그림 7-11 
은 선의 너비가 1 〜 3 에서 변하고 중간선너비가 0 〜 2 에서 변하는 틀들의 형태를 보여준다 . 
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그림 7-ll.BoxQFrame 형 의 27 가지 각이한 형 태 
다음 프로그람은 그림 7-11 에 보여주는 틀들을 만드는데 사용된다 . 그것은 살창배치를 
사용하여 모든 틀과 표식자들을 배치하고 각이한 환경설정을 가지는 틀을 만들어 삽입하는 
순환을 가지고있다 . 

1 /* boxframe.cpp */ 

2 #include <qlayout.h> 

3 #include <qframe.h> 

4 #include <qlabel.h> 

5 #include <kapplication.h> 

6 #include "boxframe.h" 

7 

8 int main(int argc, char **argv) 

9{ 

10 KApplication app(argc, argv, "boxframe"); 

11 BoxFrame *boxframe = new BoxFrame(); 

12 boxframe->show(); 

13 app.setMainWidget(boxframe); 

14 retum(app.exec()); 

15} 

16 

17 BoxFrame :: BoxFrame(QWidget ^parent,const char *name) 

18 : QWidget(parent,name) 

19 { 

20 QLabel *label; 

21 QFrame *frame; 
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22 QGridLayout *layout = new QGridLayout(this,6,10,5); 

23 

24 label = new QLabel("QFrame: :Box",this); 

25 label->setFont(QFont("Courier",24,QFont::Bold)); 

26 label->setAlignment(Qt :: AlignHCenter); 

27 layout->addMultiCellWidget(label,0,0,0,9); 

28 

29 label = new QLabel("Line Width",this); 

30 label->setAlignment(Qt :: AlignHCenter); 

31 layout->addWidget(label, 1,0); 

32 label = new QLabel("Mid Line",this); 

33 label->setAlignment(Qt :: AlignHCenter); 

34 layout->addWidget(label,2,0); 

35 label = new QLabel( M Sunken",this); 

36 layout->addWidget(label,3,0); 

37 layout->setRowStretch(3,1); 

38 label = new QLabel( M Plain n ,this); 

39 layout->addWidget(label,4,0); 

40 layout->setRowStretch(4,1); 

41 label = new QLabel( n Raised M ,this); 

42 layout->addWidget(label,5,0); 

43 layout->setRowStretch(5,l); 

44 

45 for(int i=0; i<9; i++) { 

46 int line Width = (i % 3)+1; 

47 int midLineWidth = i / 3; 

48 label = new QLabel( 

49 QString( M %l M ).arg(lineWidth),this); 

50 label->setAlignment(Qt::AlignHCenter); 

51 layout->addWidget(label, 1 ,i+1); 

52 label = new QLabel( 

53 QString( M %l M ).arg(midLineWidth),this); 

54 label->setAlignment(Qt: : AlignHCenter); 

55 layout->addWidget(label,2,i+1); 


56 
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57 frame = new QFrame(this); 

58 frame->setFrameStyle(QFrame: : Box | QFrame :: Sunken); 

59 frame->setLineWidth(lineWidth); 

60 frame->setMidLineWidth(midLineWidth); 

61 layout->addWidget(frame,3 ,i+1); 

62 

63 frame = new QFrame(this); 

64 frame->setFrameStyle(QFrame::Box | QFrame::Plain); 

65 frame->setLineWidth(lineWidth); 

66 frame->setMidLineWidth(midLineWidth); 

67 layout->addWidget(frame,4,i+1); 

68 

69 frame = new QFrame(this); 

70 frame->setFrameStyle(QFrame: : Box | QFrame::Raised); 

71 frame->setLineWidth(lineWidth); 

72 frame->setMidLineWidth(midLineWidth); 

73 layout->addWidget(frame,5,i+1 )； 

74 } 

75 

76 resize(600,200); 

77 layout->activate(); 

78} 

창문꼭대기의 표식자와 왼쪽에 있는 표식자들이 모두 만들어지고 24 〜 27 행에서 살창배 
치에 보관된다 . 

45 행에서 시작하는 순환고리는 9 개 렬의 틀을 현시하여야 하므로 9 번 반복한다 . 46 행과 
47 행 은 순환값을 사용함으로써 lineWidth 와 midLineWidth 값들을 계 산한다 . 현재렬의 두께 를 2 
로 현시 하기 위한 표식 자들이 48 〜 55 행 에서 만들어 진다 . 렬 안의 3 개 틀은 57 〜 73 행 에 서 만 
들어 진 다 . sefframeStyleO 의 3 개 호출은 모두 QFrame::Box 형 식 을 사용하지 만 각이 한 그림 자견 
본들이 주어진다 . 매개 틀의 선두께는 계산된 값으로 설정된다 . 

이 절에서 나머 지 실례들은 갈은 기 본코드를 사용하여 각이한 형 식의 옵션들을 현시 한 
다 . 그러나 그림에서 알수 있는것처럼 임의의 형식에 사용할수 있는 옵션은 변화한다 . 

2. Panel QFrame 

panelframe 프로그람은 그림 7-12 와 같이 Panel 틀형 태의 창문을 현시한다 . 틀은 그 닫긴 
령 역 이 표면우로 도드라지 거 나 아래로 움푹 폐 워 들어가도록 할수 있는 하나의 직 선으로 만 
든다 . 이전의 실례에서 사용한 중간선값은 틀이 하나의 직선으로 구성되므로 여기에 영향을 
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주지 않는다 . 



그림 7-12. 각이한 선두께를 가지 는 3 가지 형식의 Panel 틀 

3. WinPanel QFrame 

프로그람 winpanelframe 은 그림 7-13 에 보여 주는 창문을 현시한다 . WinPanel 틀의 모양은 
직 선너 비 가 2 화소로 설정된 Panel 틀과 같다 . WinPanel 에서 선두께는 변경할수 없다 . 이 형식 
의 틀은 원래 Windows 조작체계의 모양을 본딴것이다 . 



그림 7-13. 3 가지 형식의 WinPanel 틀 

4. QFrame 에 의한 직선그리기 

2 개의 QFrame 형식은 틀이 아니라 직선이다 . HLine 형식을 사용하여 QFrame 에 그림 7-14 
와 같이 수평선을 그릴수 있다 . Box 형태에 적용할수 있는 모든 변경은 HLine 에도 적용할수 
있다 . 즉 매개 선은 3 행으로 그려지는데 중앙선의 두께는 지정된 중간선값을 가지고 다른 
두 선의 너비는 지정된 선두께값을 가전다 . 선이 표면우로 올리솟거나 움푹 들어간것처럼 
보이도록 그늘이 설정된다 . 
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그림 7-14. 수평선으로 그린 QFrame 

그림 7-15 와 같이 수직선을 그릴수도 있다 . 수직선은 수평선과 갈은 옵션들을 사용하여 
구성할수 있 다 . 



그림 7-15. 수직선으로 그러진 QFrame 


제7절. 창문의 실제상태공유 

QSplitter 창문부품을 리용하면 창문에 1 개 이상의 창문부품을 현시하고 개별적인 창문부 
품들이 겹치지 않도록 사용자가 크기를 변경할수 있다 . 그림 7-16 은 한쌍의 본문편집창문을 
포함하는데 사용되고있는 분할기를 보여준다 . 













S = -L/usr/lib/kde3 S) 
-U(QTD1R)/Iib usr/Xl 1R6/Iib 
decore -lkdeui -lqt-mt -lXext |l 
-lm 


INCPATH = -I/usr/include/kde 
-I/usr/lib/qt-3.3/mkspecs/default 
-1. -I. -I$(QTDIR)/include 
LINK = g++ 

LFLAGS = 

LIBS = -L/usr/lib/kde3 
$(SUBL1BS) -U(QTD1R)/Iib 
-L/usr/Xl 1R6/Ub -lkdecore 
-lkdeui -lqt-mt -lXext -1X11 
-lm 


그림 7-16. 2 개의 편집창문을 포함하는 QSplitter 
2 개 편집구획사이의 띠는 이동할수 있고 한 창문부품의 너비가 커질 때 다른 창문부품 
의 크기 도 커진다 . 이 실례 에서 편집창문부품들은 현시 하고있는 본문이 자동적 으로 행 바꾸 
어지 도록 설정되 므로 그림 7-17 처 럼 띠 를 왼쪽으로 이 동하면 두 편집창문부품들의 크기 가 
변경 되 고 본문은 스스로 재 배렬된다 . 
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그림 7-17. 2 개 편집창문의 크기 를 변경한 결과를 보여 주는 QSplitter 
다음 프로그람은 그림 7-16 과 그림 7-17 에서 현시하는 창문들을 만든다 . 
HorizSplit 머 러 부파일 

1 /* horizsplit.h */ 

2 #ifndef HORIZSPLIT H 










3 #defme HORIZSPLIT_H 

4 

5 #include <qsplitter.h> 

6 

7 class HorizSplit: public QSplitter 
8{ 

9 Q_OBJECT 

10 public: 

11 HorizSplit(QWidget *parent=0,const char *name=0); 

12}； 

13 

14 #endif 

이 머 리부파일은 QSplitter 를 계승하는 클라스 HorizSplit 를 선언한다 . 
HorizSplit 

1 /* horizsplit.cpp */ 

2 #include <kapplication.h> 

3 #include <qmultilineedit.h> 

4 include M horizsplit.h M 

5 

6 int main(int argc, char **argv) 

7{ 

8 KApplication app(argc, argv, "horizsplit"); 

9 HorizSplit *horizsplit = new HorizSplit(); 

10 horizsplit->show(); 

11 app.setMainWidget(horizsplit); 

12 retum(app. exec()); 

13} 

14 

15 HorizSplit: : HorizSplit(QWidget ^parent,const char *name) 

16 : QSplitter(parent,name) 

17 { 

18 QMultiLineEdit *leftEdit = new QMultiLineEdit(this); 

19 leflEdit->setMinimumWidth(50); 

20 leftEdit->setWordWrap(QMultiLineEdit::WidgetWidth); 


21 
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22 QMultiLineEdit *rightEdit = new QMultiLineEdit(this); 

23 rightEdit->setMinimumWidth(50); 

24 rightEdit->setWordWrap(QMultiLineEdit::WidgetWidth); 

25 

26 resize(400,200); 

27} 

분할창문의 설정과정은 간단히 분할기안의 매개 구획들에 창문부품을 하나씩 삽입하는 
과정이다 . 15 행에서 시작되는 구성자는 이것을 부모클라스로 사용하는 2 개의 QMultiLineEdit 
객체를 만든다 . (this 는 현재객체에 대한 참고이다 .) 또한 HorizSplit 클라스는 QSplitter 클라스이고 
QSplitter 는 개 별적 인 구획들안의 자식창문부품들을 모두 관리하므로 그밖에 어떤 조작도 필 

요하지 않다 . 본문편집창문의 최 소허 용너 비 는 분할띠 의 이동에 적 은 제 한을 주기 위하여 50 

으로 설정되며 만일 아래한계를 주지 않으면 띠는 한 창문이 완전히 보이지 않을 때가지 이 

동될수 있다 . 

QSplitter 의 기 정값은 수평으로 창문부품들을 배 렬하는것 이 다 . 다음 실례는 수직 으로 창 
문부품을 배렬한다 . 

VertSplit. 

1 /* vertsplit.cpp */ 

2 #include <kapplication.h> 

3 #include <qmultilineedit.h> 

4 include "vertsplit.h" 

5 

6 int main(int argc, char **argv) 

V{ 

8 KApplication app(argc, argv, "vertsplit"); 

9 VertSplit *vertsplit = new VertSplit(); 

10 vertsplit->show(); 

11 app.setMainWidget(vertsplit); 

12 retum(app. exec()); 

13} 

14 

15 VertSplit::VertSplit(QWidget *parent,const char *name) 

16 : QSplitter(parent,name) 

17 { 

18 setOrientation(V ertical); 


19 
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20 QMultiLineEdit *topEdit = new QMultiLineEdit(this); 

21 topEdit->setMinimumHeight(50); 

22 topEdit->setWordWrap(QMultiLineEdit::WidgetWidth); 

23 

24 QMultiLineEdit *middleEdit = new QMultiLineEdit(this); 

25 middleEdit->setMinimumHeight(50); 

26 middleEdit->setWordWrap(QMultiLineEdit::WidgetWidth); 

27 

28 QMultiLineEdit *bottomEdit = new QMultiLineEdit(this); 

29 bottomEdit->setMinimumHeight(50); 

30 bottomEdit->setWordWrap(QMultiLineEdit::WidgetWidth); 

31 

32 resize ( 가 ) 0,400); 

33} 

18 행의 setOrientetionO 호출은 그 창문부품들을 겹 쳐서 배 렬하도록 QSplitter 에게 지시한 
다 . 처음에 추가된것은 꼭대기에 있다 . 분할기에 많은 창문부품을 추가할수 있는데 이 실례 
에서는 3 개의 창문부품을 포함하므로 그것들을 분리하는 2 개 띠를 가진다 . 결과를 그림 7-18 
에 보여준다 . 



그림 7-18. 3 개 편집 창문을 포함하는 수직 QSplitter 

요 약 

이 장에서는 응용프로그람과 창문을 보는 사용자에게 어떤 의미를 주도록 창문부품들 
을 구성하는데 사용할수 있는 몇가지 기본방법을 설명하였다 . 이 장은 다음과 갈은 내용을 
설명 하였다 . 

• 특수창문부품을 사용하여 단추그룹의 현시를 조직하고 그룹안의 모든 단추가 갈은 
처리부를 사용하여 마우스찰칵을 알릴수 있다 . 
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• 라지오단추그룹은 한번에 1 개 단추만 선택되도록 물리적으로 제한하여 서로 련결할 
수 있어야 한다 . 

• 검사단추 ( 절환단추)들은 물리적으로 서로 련결되지 않고 자주 론리적으로 서로 련결 
되며 그룹으로서 고찰되여야 한다 . 

• 장식틀은 창문부품주위에 그릴수 있다 . 장식보다도 틀은 혼돈되기 쉬운 현시에서 창 
문부품관계를 명백히 하는데 사용될수 있다 . 

• 창문부품집합은 갈은 공간을 공유하고 사용자가 창문부품들사이에 앞뒤로 이동하게 
할수 있다 . 
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제 8 장. 마우스와 건반 

학습내용 

하드웨 어로부터 응용프로그람에로 사건을 전달하기 
마우스자료의 읽어들이기 
마우스와 그 유표의 조종 
건반으로부터 들어오는 사건의 해석 

표준 KDE/Qt 응용프로그람은 사용자로부터 소식을 들을 때까지 아무것도 하지 않는다. 
응용프로그람이 처 음으로 실행될 때 필요한 초기 화를 하고 창문을 현시한 다음 정 지상태 에 
들어가서 사용자의 조작을 기다린다. 대다수의 경우에 프로그람은 마우스 또는 건반으로부 
터 입 력을 기다리지만 입 력은 빛펜，마우스바퀴，도형타블레트，추적볼 혹은 다른 입 력장치 
로부터도 진행될수 있다. 대부분의 응용프로그람은 창문부품의 부분으로서 포함된 미리 정 
의된 신호와 처리부들의 모임을 사용하여 작성될수 있으나 들어오는 사건흐름에 자기 프로 
그람을 직접 련결할 필요가 가끔 제기된다. 또한 만약 자체의 창문부품을 만들려고 한다면 
들어오는 사건들을 신호로 변환하는 방법을 알고있어 야 한다. 

제1절. 포구로부터 처리부에로 

먼저 사건의 생 명 주기 에 대 하여 간단히 설 명한다. 

사건발생은 하드웨어로부터 시작한다. 마우스가 새 위치로 이동하고 건반의 건을 놓고 
마우스단추를 누르거나 건이 눌러워져있다고 하자. 사건을 발생시키는 장치는 물리적으로 
콤퓨터 에 련결되므로 사건은 새치 기 를 일으키 고 구동프로그람으로 알려진 작은 프로그람은 
포구로부터 정 보를 읽어 들인다. 장치 구동프로그람의 주요한 일감은 하드웨 어사건을 쏘프트 
웨 어 사건으로 변 환하는것 이 다. 

장치구동프로그람은 특정한 포구에서 사건을 기다리도록 되여야 한다. 이것은 응용프로 
그람이 파일을 여는것과 거의 같은 방법으로 포구를 열 때 프로그람으로부터 수행된다. 포 
구들은 모두 /dev 등록부에 있고 마치도 파일인것처럼 프로그람에 의해서 보낼수 있다. 프로 
그람이 포구(즉 /dev 등록부안의 이름)를 열 때 Linux 핵심은 장치구동프로그람을 선택하고 포 
구와 응용프로그람사이에 정보를 넘기는 일감을 준다. 

(가와 KDE 에서 구동프로그람으로부터 사건을 받아들이는 응용프로그람은 X창문체계이 
다. 장치구동프로그람으로부터 오는 매개 사건은 XEvent 라는 특별한 내부형식으로 형식화된 
다. 창문관리 기 는 XEvent 를 검사하여 그 목적 창문을 결정 한다. 실례로 사건 이 건반찰칵이 면 
그것은 현재 초점을 가지는 창문에 전송된다. 그것이 마우스찰칵이라면 마우스지시기의 표와 
y 자리 표들은 보통 그 창문을 결 정한다. 어 느 창문이 사건 을 받아들이 는가 알아냄 으로써 창 
문관리기는 어느 응용프로그람이 사건을 받아들여야 하는가 결정할수 있다. 

X창문프로그람이 사건 을 처 리 하기 위 하여 함수 XNextEventO 를 읽 어 들이 는 저 준위 대 기 
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렬을 계속 호출하도록 순환고리를 설정한다. 이 함수가 돌아올 때마다 대기렬로부터 하나의 
사건을 받아들인다. 사건들은 일정한 형의 사건들을 취급하도록 할당된 메쏘드를 호출함으 
로써 응용프로그람에 발송된다. 

기본함수에서 자기 프로그람이 QApplication : : execOKApplication :: exec () 를 호출할 때 
그것은 XNextEvent () 를 호출하는 련속적 인 순환고리를 실행하여 하나의 XEvent 를 읽어들여 
Qt 사건들중 하나로 변환하고 그것을 취급하는 적당한 메쏘드를 호출한다. 

이 사건접수방법은 QWidget 클라스의 부분으로 정의되며 가상 및 비공개로서 선언된다. 
이 메쏘드들에 의해 수행된 작용은 극히 작으므로 QWidget 의 파생클라스를 만들고 사건들을 
받아들이는 메쏘드들을 재정의해야 한다. 실례로 QButton 클라스는 mouseReleaseEvent () 이라는 
QWidget 메쏘드를 재정의하여 QButton 이 clicked () 신호를 발생하도록 하게 할수 있다. 이것은 마 
우스가 단추를 동작시킬 때마다 응용프로그람이 dickedO 사건을 받아들일수 있게 한다. 


제2절. 마우스사건 

마우스사건은 현재 마우스단추들을 누르면 마우스지시기의 현재 위치를 반영한다. 
QWidget 클라스의 메쏘드는 마우스사건이 발생할 때마다 호출된다. 만일 자체로 마우스사건 
처리를 만들려고 한다면 QWidget 에서 정의된 사건조종메쏘드들을 재정의한다. 

다음의 프로그람은 마우스를 추적하고 단추，건 및 마우스지시기의 위치들을 현시한다. 
그림 8-1 과 같이 오른쪽의 빈 창문부품은 마우스이동을 감시하는 창문부품이고 매개 마우스 
작용은 왼쪽에 현시된다. 이 실례는 들어오는 사건을 신호로 변환하는 방법을 보여준다. 마 
우스사건이 들어올 때마다 그로부터 들어오는 자료는 설명문자렬을 만드는데 사용된다. 이 
문자렬은 신호로서 발생되고 다른 클라스의 처리부에 의해서 받아들여진다. 


Press ： Lft (62, 107)(456,238) i 
Move ： (Lft)- (68,119)(462,250) 
Move ： (Lft)- (74,131)(468,262) 
Move ： (Lft)- (80,143)(474,274) 
Move ： (Lft)- (84,151)(478, 期 2) 
Move ： (Lft)- (88,159)(482,290) 
Move ： (Lft)- (88,167)(482,298) 
Move ： (Lft)- (90,175)(484,306) 
Move ： (Lft)- (91,177)(485,308) 
Move ： (Lft)- (91,185)(485,316) 
Move ： (Lft)- (91,193)(485,324) 
Move ： (Lft)- (92,195)(486,326) 
Move ： (Lft)- (93,197)(487,328) 
Move ： (Lft)- (93,199)(487,330) 
Move ： (Lft)- (94,201)(488,332) 
Move ： (Lft)- (96,202)(490,333) 
Move ： (Lft)- (98,203)(492,334) 
Move ： (Lft)- (100,204) 

(494,335) 


그림 8-1. 마우스동작을 추적하고 현시하는 프로그람 
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MouseSensor 머 리 부파 일 

1 /* mousesensor.h */ 

2 #ifiidef MOUSESENSOR_H 

3 #define MOUSESENSOR_H 

4 

5 #include <qwidget.h> 

6 #include <qevent.h> 

7 #include <qstring.h> 

8 

9 class MouseSensor: public QWidget 

10 { 

11 Q_OB JECT 

12 public: 

13 MouseSensor(QWidget *parent=0,const char *name=0); 

14 private: 

15 void emitDescription(const QString &,QMouseEvent *); 

16 virtual void mousePressEvent(QMouseEvent * event); 

17 virtual void mouseReleaseEvent(QMouseEvent *event); 

18 virtual void mouseDoubleClickEvent(QMouseEvent * event); 

19 virtual void mouseMoveEvent(QMouseEvent *event); 

20 signals: 

21 void description(QString &); 

22 }; 

23 

24 #endif 

MouseSensor 클라스는 마우스동작을 추적하는 창문부품이다 . 그것은 그림 8-1 의 오른쪽 
에 빈 창틀 ( 구획)로서 나타난다 . 16 〜 19 행의 가상메쏘드들은 기초클라스 QWidget 의 메쏘드들 
을 재정의 하므로 모든 마우스사건들은 기 초클라스가 아니 라 가상메 쏘드들에 들어 온다 . 
MouseSensor 

1 /* mousesensor.cpp */ 

2 #include <qstring.h> 

3 #include "mousesensor.h" 

4 

5 MouseSensor::MouseSensor(QWidget ^parent,const char *name) 

6 : QWidget(parent,name) 
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7{ 

8 setMinimumSize(300,300); 

9} 

10 void MouseSensor::mousePressEvent(QMouseEvent *event) 

11 { 

12 emitDescription(QString("Press:"),event); 

13} 

14 void MouseSensor: :mouseReleaseEvent(QMouseEvent *event) 

15 { 

16 emitDescription(QString("Release : M ),event); 

17} 

18 void MouseSensor::mouseDoubleClickEvent(QMouseEvent *event) 

19 { 

20 emitDescription(QString( M DoubleClick:"),event); 

21 } 

22 void MouseSensor::mouseMoveEvent(QMouseEvent *event) 

23 { 

24 emitDescription(QString("Move : "),event); 

25} 

26 void MouseSensor::emitDescription(const QString &typeStr, 

27 QMouseEvent * event) 

28 { 

29 QString btnStr(typeStr); 

30 ButtonState state = event->state(); 

31 if(state & ControlButton) 

32 btnStr+= 

33 if(state & AltButton) 

34 btnStr+= "Alt-"; 

35 if(state & ShiflButton) 

36 btnStr+= "Shft-"; 

37 if(state & LeftButton) 

38 btnStr+="(Lft)-" ; 

39 if(state & MidButton) 

40 btnStr+= "(Mid)-"; 

41 if(state & RightButton) 
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42 btnStr+= ，， (Rgt)-，，; 

43 Buttons tate button = event->button(); 

44 if(button & LeftButton) 

45 btnStr+= "Lft"; 

46 if(button & MidButton) 

47 btnStr+= ，， Mid，，; 

48 if(button & RightButton) 

49 btnStr+= "Rgt"; 

50 

51 QString str = QString("%l (%2,%3)(%4,%5)") 

52 .arg(btnStr) 

53 .arg(event->x()).arg(event->y()) 

54 .arg(event->globalX()).arg(event->globalY()); 

55 

56 emit description(str); 

57} 

MouseSensor 클라스는 QWidget 를 기초클라스로 사용하므로 창문부품이다 . 이 클라스에서 
마우스사건들을 받아들이는 4 개 메쏘드는 기초클라스의 4 개 가상메쏘드를 재정의한다 . 메쏘 
드 mousePressEvent() 는 마우스단추들중 하나를 누를 때마다 호출되며 메쏘드 
mouseReleaseEventO 는 마우스단추들중 하나를 놓을 때마다 호출된다 . 메쏘드 
mouseDoubleClick() 는 마우스단추를 일정한 시간간격으로 두번 눌렀다 놓을 때마다 호출된다 . 
이것은 두번찰칵작용이 5 개의 사건 즉 2 개의 단추누르기사건， 2 개의 단추놓기사건 그리고 1 
개 의 두번 찰칵사건 을 생 성 한다는것 을 의 미한다 . 

22 행의 메쏘드 mouseMoveEventO 는 마우스가 창문안의 새로운 위치로 이동될 때마다 
호출된다 . 2 가지 조작방법이 있다 . 그 방법은 매개 마우스이동에 대하여 호출되거나 마우스 
단추를 누르고 이동할 때만 호출될수 있다 . 기정은 단추들중의 하나를 누르고있을것을 요구 
하지만 메쏘드 setMouseTracking(TRUE) 호출은 마우스위치를 항상 통보한다 . 

26 행에서 시작하는 emitDescriptionO 은 서술문자렬을 만들고 문자렬을 포함하는 신호를 
보내 는 모든 사건수신 메 쏘드들에 의 해 사용된 다 . 정 보는 모두 QMouseEvent 객 체안에 있다 . 

ButtonState 값은 30 행 에서 사건의 state() 메쏘드를 호출함으로써 얻어 진다 . 이 변수는 마 
우스사건이 발생한 시간에 누르고있는 단추들 ( 있다면)을 표시하는 기발들을 보관한다 . 6 개의 
가능한 단추를 설 정할수 있 다 . 즉 Alt, Ctrl, 그리 고 Shift 와 함께 3 개 마우스단추 . 43 행 의 
buttonO 호출에 의해 얻어진 ButtonState 값은 사건을 일으킨 단추 ( 있다면 ) 이다 . 실례로 Cttl 건과 
오른쪽 마우스단추를 누르고있으면 왼쪽 마우스단추누르기 는 Ctrl 건과 오른쪽마우스단추지 시 
기가 state() 호출로 되돌아오게 하고 왼쪽 마우스단추지시기는 button() 으로 되돌아오게 한다 . 
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알아두기 : Alt 건은 ButtonState 의 기발값에 의해 표시되며 Alt 건은 실제로 마우스사건에 
서 통보되지 않는다 . 이것은 KDE 가 Alt 건을 마우스와 함께 사용할 때 Alt 건을 받아들 
이 기때문이 다 . Alt - 왼쪽마우스단추는 창문을 이 동하는데 사용되 고 Alt - 중간단추는 초점 
을 다음 창문으로 이동하며 Alt-right 단추는 현재 창문을 다시 조절한다 . 2 단추마우스를 
사용하면 대 체로 동시 에 두 단추를 누름으로써 가운데 단추를 모의할수 있고 Alt 건 없 
는 건반은 일반적으로 갈은 동작을 하는 메타건을 가지고있다 . 

QMouseEvent 객 체 에 2 개 의 마우스위 치 가 있 다 . 하나는 전 체 창문의 왼 쪽웃구석 에 관한 x 
와 y 자리 표를 표시 하며 다른것 은 현재 창문의 왼 쪽웃구석 의 x 와 y 값을 표시한다 . 51 행 에 서 
QString 객체는 사건의 설명을 보유하기 위해 만든다 . 53 행과 54 행은 사건을 설명하는 문자렬 
로서 자리표들을 형식화한다 . 대체로 국부자리표들은 자기가 바라는것이지만 가끔 마우스의 
대역 ( 세계)위치를 알아야 한다 . 

56 행의 emit 문은 들어오는 사건을 나가는 신호로 변환하는 마지막 단계이다 . 이러한 부 
류의 처리는 실례로 마우스단추사건을 clickO 라는 이름의 신호로 변환하는 QPushButton 에서 
발생한다 . 이 실례에서 사건의 설명을 담고있는 QStting 이 포함된 신호가 발생된다 . 
FollowMouse 머 리 부파일 

1 /* followmouse.h */ 


2 #ifndef FOLLOWMOUSE_H 

3 #defme FOLLOWMOUSE_H 

4 

5 #include <qsplitter.h> 

6 #include <qstring.h> 

7 #include <qmultilineedit.h> 

8 

9 class FollowMouse: public QSplitter 

10 { 

11 Q_OBJECT 

12 public: 

13 FollowMouse(QWidget *parent=0,const char *name=0); 

14 public slots: 

15 void newline(QString &); 

16 private: 

17 QMultiLineEdit *edit; 

18 }； 

19 


20 #endif 
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FollowMouse 클라스는 그림 8-1 에 서 이 미 보여 준 최 상위창문이 다 . 그것 은 왼쪽의 
QMultiLineEdit 객체와 오른쪽의 MouseSensor 객체를 모두 관리 하는 QSplitter 에 기초하고 있 다 . 
FollowMouse 

1 /* followmouse.cpp */ 

2 #include <kapplication.h> 

3 #include <qstring.h> 

4 #include "mousesensor.h” 

5 #include "followmouse.h M 

6 

7 int main(int argc, char **argv) 

8{ 

9 KApplication app(argc, argv, "followmouse"); 

10 FollowMouse *followmouse = new FollowMouse(); 

11 followmouse->show(); 

12 app.setMainWidget(followmouse); 

13 retum(app. exec()); 

14} 

15 

16 FollowMouse: :FollowMouse(QWidget *parent,const char *name) 

17 : QSplitter(parent,name) 

18 { 

19 edit = new QMultiLineEdit(this); 

20 edit->setMinimumWidth(80); 

21 edit->setReadOnly(TRUE); 

22 

23 MouseSensor * sensor = new MouseSensor(this); 

24 sensor->setMinimumWidth(80); 

25 

26 connect(sensor,SIGNAL(description(QString &)), 

27 this,SLOT(newline(QString &))); 

28 

29 resize(10,10); 

30} 

31 void FollowMouse :: newline(Q String &str) 

32 { 
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33 edit->insertLine(str); 

34 edit->setCursorPosition(5000,0); 

35} 

16 행에서 시작하는 FollowMouse 구성자는 19~21 행에서 QMultiLineEdit 창문부품을 만든 
다 . setReadOnlyO 호출은 편집을 금지하고 편집기를 현시만 할수 있는 본문창문으로 만든다 . 
편집 기창문부품이 처 음으로 만들어 지 므로 그것 이 왼쪽에 나타난다 . 23 행 에서 만들어 진 
MouseSensor 는 오른쪽에 나타난다 . 

이 클라스가 마우스사건서술을 받아들이기 위하여 26 행에서 connectO 호출을 만들고 
FollowMouse 의 description () 신호로부터 MouseSensor 의 처리부 newLineO 에로의 련결을 확립한다 . 

31 행의 처리부메쏘드는 모든 마우스사건의 서술문자렬과 함께 호출된다 . 33 행의 
insertLine() 호출은 QMultiLineEdit 창문부품에 현시 된 본문의 아래에 문자렬을 추가한다 . 
setCursorPos () 호출은 가장 새로운 문자렬(바닥에 있는것:)이 보인다는것을 담보한다 . 목록의 
실제성원수를 넘는 첨수를 지정하면 QMultiLineEdit 이 마지막것을 선택한다 . 

제3절. 마우스의 포획과 해방 

응용프로그람에는 마우스를 조종할수 있는 창문부품이 있다 . 이것은 마우스지시기의 이 
동은 제한하지 않지만 다른 모든 창문부품들(이것 또는 다른 응용프로그람안의)이 마우스사 
건을 받아들이는것을 금지한다 . 

경고 마우스를 포획하면 또한 해방기구가 있는가 확인하여야 한다 . 자기의 프로그람이 마우 
스를 포획한 다음 해방하지 않으면 마우스는 잠그어진다 . 즉 건반은 동작하지만 마우스는 
자기의 프로그람이 끝날 때까지 사용금지된다 . 

다음 프로그람은 그림 8-2 에 서 보여 준것 과 갈은 창문을 현시한다 . 꼭대 기단추는 마우스 
를 포획하고 유표를 십자모양으로 변경한다 . 아래 단추는 마우스를 해방한다 . 



그림 8-2. 마우스의 포획 

GrabMouse 머 리 부파 일 

1 /* grabmouse.h */ 

2 #ifndef GRABMOUSE_H 

3 #defme GRABMOUSE H 

4 
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5 #include <qwidget.h> 

6 #include <qlayout.h> 

7 #include <qpushbutton.h> 

8 

9 class GrabMouse: public QWidget 

10 { 

11 Q_OBJECT 

12 public: 

13 GrabMouse(QWidget *parent=0,const char *name=0); 

14 private: 

15 QPushButton *grabButton; 

16 QPushButton *relButton; 

17 public slots: 

18 void mouse_grab(); 

19 void mouse_release(); 

20 }; 

21 

22 #endif 


GrabMouse 

1 /* grabmouse.cpp */ 

2 #include <kapplication.h> 

3 #include <qcursor.h> 

4 #include ’’grabmouse.h” 

5 

6 int main(int argc, char **argv) 

V{ 

8 KApplication app(argc, argv, "grabmouse"); 

9 GrabMouse *grabmouse = new GrabMouse(); 

10 grabmouse->show(); 

11 app.setMainWidget(grabmouse); 

12 retum(app. exec()); 

13} 

14 

15 GrabMouse::GrabMouse(QWidget *parent,const char *name) 
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16 : QWidget(parent,name) 

17 { 

18 QVBoxLayout *layout = new QVBoxLayout(this,20); 

19 

20 grabButton = new QPushButton( n Grab Mouse",this); 

21 grabButton->setMinimumSize(grabButton->sizeHint()); 

22 layout->addWidget(grabButton); 

23 connect(grabButton,SIGNAL(clicked()), 

24 this,SLOT(mouse_grab())); 

25 

26 relButton = new QPushButton( "Release Mouse",this); 

27 relButton->setMinimumSize(relButton->sizeHint()); 

28 layout->addWidget(relButton); 

29 connect(relButton,SIGNAL(clicked()), 

30 this,SLOT(mouse_release())); 

31 

32 resize(10,10); 

3 3 layout->activate(); 

34} 

35 void GrabMouse: : mouse_grab() 

36 { 

37 relButton->grabMouse(QCursor(CrossCursor)); 

38} 

39 void GrabMouse: : mouse_release() 

40 { 

41 relButton->releaseMouse(); 

42} 

GrabMouse 클라스는 18 행에서 한쌍의 단추들을 가진 수직칸을 사용하는 창문부품이다 . 
grabButton 이라는 우에 있는 단추는 35 행에서 정의된 처리부메쏘드 mouse_grab () 에 련결된 
clicked 。 신호를 가지고있다 . 마찬가지로 relButton 은 39 행에서 정의된 처리부메쏘드 
mouse_released () 에 련결된 다 . 

우의 단추가 선택될 때마다 relButton 의 grabMouse () 메쏘드가 호출되여 relButton 이 마우 
스를 포획하게 한다 . grabMouseO 에 유표정의를 넘기면 포획기간에 유표모양이 변경되게 한 
다 . 그것은 포획을 실행한 relButton 이므로 마우스에 응답할 유일한 창문부품이며 체계에 마 
우스조종을 돌려보내기 위하여 releaseMouseO 를 호출한다 . 
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제 4 절. 유표의 형태변경 

내부유표의 표준모임을 사용하여 프로그람의 현재상태를 사용자에게 통지할수 있다 . 유 
표를 변경하는 메쏘드는 QWidget 에 있으므로 어떠한 현시가능객체라도 변경된 유표를 가질 
수 있다 . 

유표의 모양을 바꿀 때 변경은 오직 자기가 지정한 구역에 적용한다 . 실례로 자기 응용 
프로그람의 최상위창문을 위한 유표를 변경한다면 그것은 제목띠를 변경하지 않지만 자기의 
최상위창문의 자식 이 나 또는 자손인 모든 창문부품들을 변경 한다 . 그러 나 자식 창문부품들중 
의 하나가 자기 유표설정을 가지고있다면 그것(과 그아래의 모든 자손)은 자기의 유표를 가 
지고있다 . 

다음 실례는 모든 표준유표중에서 동적으로 선택할수 있게 한다 . 전체 창문에 한개 유 
표를 적용하고 창문내부의 한개 단추에 다른 유표를 적용할수 있다 . 그림 8-3 에 보여준것처 
럼 유표들의 이름은 왼쪽에 렬거된다 . 유표이름이 선택될 때마다 그것은 전체 창문에 대하 
여 기정유표로 된다 . 오른쪽에 있는 Select 단추를 사용하면 현재 선택한 유표가 그 자체의 
개별적인 유표로서 할당되도록 한다 . 즉 그의 유표가 더는 그 부모로부터 계승되지 않는다 . 
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그림 8-3. 유표선택목록 


CursorMouse 머 리 부파 일 

1 /* cursormouse.h */ 

2 #ifndef CURSORMOUSE_H 

3 #defme CURSORMOUSE_H 

4 

5 #include <qlayout.h> 

6 #include <qpushbutton.h> 


8 class CursorMouse: public QWidget 


189 







9{ 

10 Q_OBJECT 

11 public: 

12 CursorMouse(QWidget *parent=0,const char *name=0); 

13 private: 

14 QPushButton *selectButton; 

15 QPushButton *exitButton; 

16 int cursorlD; 

17 public slots: 

18 void changeCursor(int); 

19 void selectCursor(); 

20 void shutdown(); 

21 }； 

22 

23 #endif 

CursorMouse 클라스는 3 개의 처리부를 포함한다 . 그중 2 개는 유표를 변경하는데 사용되 
고 3 번째는 프로그람을 완료한다 . 16 행에 선언된 cursorlD 는 현재 선택된 유표의 ID 번호를 보 
관한다 . 

CursorMouse 

1 /* cursormouse.cpp */ 

2 #include <kapplication.h> 

3 #include <qcursor.h> 

4 #include <qlistbox.h> 

5 #include "cursormouse.h” 

6 

7 struct cursStruct { 

8 QString name; 

9 int number; 

10 } curs[] = { 

11 {'*ArrowCursor 1 *,ArrowCursor }, 

12 {"UpArrowCursor" ,UpArrowCursor }, 

13 {"CrossCursor",CrossCursor }, 

14 { M WaitCursor",WaitCursor}, 

15 {"IbeamCursor",IbeamCursor}, 

16 { n SizeVerCursor n ,SizeVerCursor}, 
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17 {"SizeHorCursor",SizeHorCursor}, 

18 {"SizeBDiagCursor",SizeBDiagCursor}, 

19 {"SizeFDiagCursor",SizeFDiagCursor}, 

20 {"SizeAllCursor",SizeAllCursor }, 

21 { n BlankCursor",BlankCursor}, 

22 { n SplitYCursor M ,SplitVCursor}, 

23 { M SplitHCursor M ,SplitHCursor}, 

24 { "PointingHandCursor",PointingHandCursor }, 

25 { "BitmapCursor",BitmapCursor } 

26}; 

27 

28 int main(int argc, char **argv) 

29 { 

30 KApplication app(argc, argv, "cursormouse"); 

31 CursorMouse *cursormouse = new CursorMouse(); 

32 cursormouse->show(); 

3 3 app. setMainW idget(cursormouse); 

34 return (app.exec()); 

35} 

36 

37 CursorMouse :: CursorMouse(QWidget ^parent,const char *name) 

38 : QWidget(parent,name) 

39 { 

40 QHBoxLayout *horlayout = new QHBoxLayout(this); 

41 

42 QListBox *list = new QListBox(this); 

43 for(int i=0; i<sizeof(curs)/sizeof(cursStruct); i++) 

44 list->insertltem(curs[i] .name); 

45 horlayout->addWidget(list); 

46 connect(list,SIGNAL(highlighted(int)), 

47 this,SLOT(changeCursor(int))); 

48 

49 QVBoxLayout *verlayout = new QVBoxLayout(3 0); 

50 

51 selectButton = new QPushButton("Select n ,this); 
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52 selectButton->setMinimumSize(selectButton->sizeHint()); 

53 verlayout->addWidget(selectButton); 

54 connect(selectButton,SIGNAL(clicked()), 

55 this,SLOT(selectCursor())); 

56 

57 exitButton = new QPushButton("Exit M ,this); 

58 exitButton->setMinimumSize(exitButton->sizeHint()); 

59 verlayout->addWidget(exitButton); 

60 connect(exitButton,SIGNAL(clicked()), 

61 this,SLOT (shutdown())); 

62 

63 horlayout->addLayout(verlayout); 

64 

65 resize(250,200); 

66 horlayout->activate(); 

67} 

68 void CursorMouse: :changeCursor(int index) 

69 { 

70 cursorlD = curs[index] .number; 

71 setCursor(QCursor(cursorID)); 

72} 

73 void CursorMouse :: selectCursor() 

74 { 

7 5 selectButton->setCursor(QCursor(cursorID)); 

76} 

77 void CursorMouse :: shutdown() 

78 { 

79 kapp->exit(0); 

80} 

7 〜 26 행의 배렬은 미리 정의된 유표들의 이름과 ID 번호들을 보관한다 . 이름들은 목록칸 
에서 선택본문으로 사용되며 ID 값들은 QCursor 의 구성자에서 인수로 사용된다 . 

37 행 에서 선 언되 는 CursorMouse 클라스는 응용프로그람의 최 상위창문부품이 다 . 그것 은 
그림 8-3 에 보여준것처럼 수평칸을 리용하여 왼쪽에 QListBox 를 보유하고 수직칸에 2 개 단 
추를 보관한다 . 

목록칸은 43 행에서 만든다 . 43 행과 44 행의 순환은 목록칸에 유표이름들을 추가한다 . 46 
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행에서 connect () 호출은 changeCursor () 라는 이름의 국부처리부와 highlighted () 라는 목록칸신호 
를 련결한다 . changeCursor () 는 목록칸성원을 선택할 때마다 실행된다 . 여기서 그것을 사용하 
지 않지만 목록칸성원우에서 두번찰칵을 요구하는 목록칸으로부터 오는 selectedO 신호는 있 
다 . 두 목록칸신호들은 목록칸항목의 첨수번호를 제공한다 . 

selectButton 은 51 행에서 만들어지고 국부처리부 selectCursor () 에 련결된 clicked () 신호를 
가지고있다 . exitButton 은 57 행에서 만들어지며 국부처리부 shutdown () 에 련결된 clicked () 를 가 
지고있다 . 

68 행의 처리부메쏘드 changeCursorO 에는 매번 최근에 선택한 목록칸항목의 첨수가 넘어 
온다 . 목록칸의 본문은 배렬이름으로부터 적재되였으므로 목록칸으로부터 오는 첨수도 역시 
배 렬의 첨 수이 다 . 70 행은 배렬로부터 유표 正)를 꺼 내서 cursorlD 에 보관하고 그것을 현재 유 
표正)번호로 한다 . 기행 에 서 setCursor () 호출은 인수로서 유표를 제 공된것으로 설 정한다 . 
QCursor 구성자는 목록칸으로부터 선택될 때 미리 정의된 유표들중 하나의 유표 ID 를 받아들 
인다 . 

73 행에서 처리부메쏘드 selectCursorO 는 selectButton 의 유표를 현재 선택한 유표로 설정 
한다 . 이 단추에 어떤 유표도 설정되지 않았다면 그것은 그 부모창문(즉 기행 에서 정의한 유 
표)과 같은것을 사용한다 . 75 행 에서 일단 setCursorO 호출이 이루어지면 selectButton 은 그 자체 
의 유표를 사용한다 . 

이 모든것은 3 개 유표가 하나의 응용프로그람에 사용된다는것을 의미한다 . 기정유표 
(ArrowCursor ᅵ는 기본창문의 제목띠에 계속 사용된다 . 현재 목록칸에서 선정되는 어느 유표 
나 기본창문내부의 어디서나 사용된다 . 유일한 례외는 Select 단추가 그것을 늘렸을 때 선정 
된 자기의 유표를 가지고있는것이다 . 

목록에 2 개의 득수유표가 있다 . BlankCursor 라는 유표는 도형을 가지지 않고 유표는 표 
시되지 않는다 . 그것은 여전히 이동하여 찰칵할수 있는 유표이지만 그것을 알수 없다 . 다른 
특수한 유표는 BitmapCursor 이다 . 이것이 동작하자면 자기가 만든 유표를 제공하여야 하는데 
그것은 다음 절에서 보게 된다 . 


제5절. 자체의 유표설계 

유표는 화소들로 이루어진 직 4 각형이다 . 매개 화소는 흑색，백색이거나 투명색일수 있 
다 . 실례 로 KDE 기 정 화살유표는 흰 테두리 를 가지 는 흑색화살표이다 . 다른 모든 화소들은 투 
명색 이다 . 한가지 색으로 칠하고 다른 색으로 테두리를 그리 면 유표가 지 나는 배경색 에 관 
계없이 유표를 볼수 있다 . 

유표를 만들려면 2 개의 비트매프를 만들어야 한다 . 두 비트매프는 그들중 하나가 다른 
것과 겹치는 마스크이므로 같은 높이와 너비를 가져야 한다 . 화소당 lbit 만 있으므로 마스크 
가 필요하지만 화소를 현시하는 방법은 3 가지 있다 . 즉 흑색 , 백색 , 혹은 투명색 . 

그림 8-4 에서 16X16 유표형태를 보여준다 . 제일 우의 화소는 그 안에 다이야몬드가 있 
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으며 이 유표의 열점 (hot spot ) 으로 된다 . 열점은 보통 지시기의 끝 또는 +자의 중심에 있으 


며 응용프로그람에 통보되 는 정 확한 유표위 치 를 결 정한다 . 그림 8-5 에 서 는 유표용마스크로서 
동작하는 다른 비트매프를 보여준다 . 두 비트매프는 표 8-1 의 규칙 에 따라 결합된다 . 

표 8-1. 유표비트매프현시규칙 


유표비트설정 

유표마스크비트설정 

결과 

1 

1 

흑색 

0 

1 

백색 

0 

0 

투명 


t. 


그림 8-4. 유표형태의 정의 



그림 8-5. 유표마스크의 정의 

유표를 설명하는 비트매프를 만드는데 쓰이는 몇가지 편의프로그람들이 있다 . 하나는 
XII 체계의 부분으로 제공된다 . 이것은 보통 /usr/XllR6/bin/bitmap 에 있고 16X16 유표화상을 
만드는데 사용한다 . 프로그람실행을 시작하고 마우스로 화소들을 선택한다 . 일반적으로 이 
편의프로그람과 비트매프에 대해서는 9 장에서 설명한다 . 

다음 실례는 유표를 만들기 위하여 그림 8-4 와 8-5 에 보여준 유표비트매프를 사용한다 . 
MyCursor 머 리 부파 일 


2 #i&def GRABMOUSE_H 

3 #defme GRABMOUSE H 
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5 #include <qwidget.h> 


7 class MyCursor: public QWidget 

8 { 

9 public: 

10 MyCursor(QWidget *parent=0,const char *name=0); 

11}； 

12 

13 #endif 


MyCursor 

1 /* mycursor.cpp */ 

2 #include <kapplication.h> 

3 #include <qcursor.h> 

4 #include <qbitmap.h> 

5 #include "mycursor.h” 

6 

7 #define upleft_width 16 

8 #define upleft_height 16 

9 #define upleft_x_hot 6 

10 #define upleft_y_hot 1 

11 static unsigned char upleft_bits[] = { 

12 0x00, 0x00, 0x40, 0x00, OxeO, 0x00, OxfO, 0x01, Ox 松， 

13 0x03, Oxfc, 0x07, Oxfe, OxOf, OxfO, 0x01 ， OxfD, 0x01 ， 

14 OxfD, 0x01 ， OxfO, 0x01 ， OxfD, 0x7f, OxfO, 0x7f, OxfO, 

15 0x7f, OxfO, 0x7f, 0x00, 0x00}; 

16 

17 #define upleftmask_width 16 

18 #define upleftmask_height 16 

19 static unsigned char upleflmask_bits[] = { 

20 0x40, 0x00, OxeO, 0x00, OxfD, 0x01, 0xf8, 0x03, Oxfc, 

21 0x07, Oxfe, OxOf, Oxff, Oxlf, Oxff, Oxlf, Oxf8, 0x03, 

22 Ox 松， 0x03, Oxf8, Oxff, Oxf8, Oxff, Oxf8, Oxff, Oxf8, 

23 Oxff, 0xf8, Oxff, Ox 後， Oxff}; 
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24 

25 int main(int argc, char **argv) 

26 { 

27 KApplication app(argc, argv, "mycursor"); 

28 MyCursor *mycursor = new MyCursor(); 

29 mycursor->show(); 

30 app.setMainWidget(mycursor); 

31 retum(app. exec()); 

32} 

33 

34 MyCursor: : MyCursor(QWidget ^parent,const char *name) 

35 : QWidget(parent,name) 

36 { 

37 QBitmap uplefl(upleft_width,upleft_height, 

38 upleft_bits,TRUE); 

39 QBitmap upleftmask(upleftmask_width,upleftmask_height, 

40 upleftmask_bits,TRUE); 

41 QCursor upleftCursor(upleft,upleftmask, 

42 upleft_x_hot,upleft_y_hot); 

43 setCursor(upleflCursor); 

44 resize(100,100); 

45} 

유표본체는 7 〜 15 행에서 정의된다 . 이 형식의 자료는 비트매프편의 프로그람으로부터 의 
실제 출력이며 간단히 프로그람의 원천코드에 삽입되였다 . 유표의 높이와 너비 , 그리고 열점 
의 위치는 모두 상수로 정의된다 . 자기가 좋아하는 크기의 유표를 만들수 있으나 대부분의 
유표는 16X16 또는 32X32 화소들이다 . 유표마스크에 사용하는 비트매프는 17 〜 23 행에서 정 
의된다 . 

비트매프자료를 유표로 변환하는 수속은 34 행에서 시작하는 구성자에 있다 . 37 행에서 
QBitmap 객체를 만드는데 유표비트매프자료를 사용한다 . 같은 방법으로 39 행에서 QBitmap 을 
만들 때 마스크를 사용한다 . 정의된 상수들은 QBitmap 구성자에서 비트배렬에 적용할 높이와 
너비를 결정하는데 필요하다 . 끝으로 두 비트매프와 열점의 위치를 사용하여 41 행에서 유표 
를 만든다 . 43 행 의 setCursorO 호출은 현재창문에 유표화상을 설치한다 . 결과는 그림 8-6 에 보 
여준다 . 
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IMBP 


그림 8-6. 사용자정의유표 

제6절. 건반사건 

건반은 보통 2 개 사건을 발생시킨다 . 하나는 건을 누를 때 , 다른 하나는 건을 놓을 때 
발생한다 . 이 것은 쏘프트웨어 가 어 떤 건결합을 누르고있는가 결정할수 있게 한다 . 실례로 
Shift 건을 누르고 놓지 않는다면 문자건은 소문자가 아니라 대문자로 인식된다 . Qt 서고는 건 
들을 정 의한다 . 

다음 프로그람은 그림 8-7 에 보여 준 2 구획창문을 현시한다 . 오른쪽의 구획 은 건누르기 
정보를 받아들이도록 설정되고 매개 건치기는 왼쪽구획에 목록된다 . 매개 행은 Press 혹은 
Release 사건인가를 가리키는 P 또는 묘로 시작한다 . 두점뒤의 수는 건의 유일식별번호이다 . 
그뒤에 건서술이 온다(그러나 이 실례에서는 설명이 없다 ;). 건반사건이 건을 누르고있기때문 
에 생성되였다면 단어 "repeat " 가 오른쪽에 나타난다 . 


그림 8-7. 매개 건치기로부터 오는 정보의 현시 
알아두기 : Qt 는 약 240 개 의 유일건을 인식 한다 . 그러 나 Control, Alt 및 Shift 건결 합과 특 
수건들과 특수문자를 가지고있으므로 모두 약 2000 개나 된다 . 특수건에 대한 전체목 
록은 파일 qnamespace.h 에 있다 . 


Alt-AltAlt-AltAlt 
83s 70 fl41314131 0 Alt41314131 


r 4 o 4 4 o ^ 

r- R:R: p: R:R: p: R:R:D- 
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FollowKeyboard 머 리 부파일 

1 /* followkeyboard.h */ 

2 #ifndef FOLLOWKEYBOARD_H 

3 #define FOLLOWKEYBOARD_H 

4 

5 #include <qsplitter.h> 

6 #include <qstring.h> 

7 #include <qmultilineedit.h> 

8 

9 class FollowKeyboard: public QSplitter 

10 { 

11 Q_OB JECT 

12 public: 

13 FollowKeyboard(QWidget *parent=0,const char *name=0); 

14 public slots: 

15 void newline(QString &); 

16 private: 

17 QMultiLineEdit *edit; 

18}； 

19 

20 #endif 

FollowKeyboard 

1 /* followkeyboard.cpp */ 

2 #include <kapplication.h> 

3 #include <qstring.h> 

4 #include ’’keyboardsensor.h" 

5 #include ’’followkeyboard.h’’ 

6 

7 int main(int argc, char **argv) 

8{ 

9 KApplication app(argc, argv, ’’followkeyboard"); 

10 FollowKeyboard *followkeyboard = new FoliowKeyboard(); 

11 followkeyboard->show(); 

12 app.setMainWidget(followkeyboard); 
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13 retum(app. exec()); 

14} 

15 

16 FollowKeyboard::FollowKeyboard(QWidget ^parent, 

17 const char *name) : QSplitter(parent,name) 

18 { 

19 edit = new QMultiLineEdit(this); 

20 edit->setMinimumWidth(80); 

21 edit->setReadOnly(TRUE); 

22 edit->setMinimumWidth(200); 

23 

24 KeyboardSensor * sensor = new KeyboardSensor(this); 

25 sensor->setMinimumWidth(80); 

26 

27 connect(sensor,SIGNAL(description(QString &)), 

28 this,SLOT(newline(QString &))); 

29 

30 resize(10,10); 

31} 

32 void FollowKeyboard: : newline(QString &str) 

33 { 

34 edit->insertLine(str); 

35 edit->setCursorPosition(5000,0); 

36} 

16 행에서 시작하는 FollowKeyboard 구성자는 2 개 창문부품을 가지고있는 수평 QSplitter 창 
문부품이다 . 왼쪽에 있는것은 본문을 현시하는데 사용되는 QMultiLineEdit 객체이고 오른쪽에 
있는것은 건치기정보를 받아들이는데 사용되는 KeyboardSensor 창문부품이다 . 32 행의 처리부 
메쏘드 newlineO 은 QMultiLineEdit 객체에서 본문의 아래에 문자렬을 추가한다 . 35 행의 
setCursorPosition() 호출은 본문창문의 제일 끝행을 표시한다 . 

KeyboardSensor 머 리 부파일 

1 /* keyboardsensor.h */ 

2 #ifndef KEYBOARDSENSOR_H 

3 #define KEYBOARDSENSOR_H 

4 


5 #include <qwidget.h> 
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6 #include <qevent.h> 

7 #include <qstring.h> 

8 

9 class KeyboardSensor: public QWidget 

10 { 

11 Q_OBJECT 

12 public: 

13 KeyboardSensor(QWidget *parent=0,const char *name=0); 

14 private: 

15 void emitDescription(const QString &,QKeyEvent *); 

16 virtual void keyPressEvent(QKeyEvent *event); 

17 virtual void keyReleaseEvent(QKeyEvent *event); 

18 signals: 

19 void description(QString &); 

20 }; 

21 

22 #endif 

이 머 리부파일은 클라스 KeyboardSensor 를 QWidget 의 파생클라스로 선언한다 . 16 행과 17 
행에서 keyPressEvent() 와 keyReleaseEvent() 의 선언은 QWidget 기초클라스의 함수들을 재정의 
하며 그것들은 매개 건치기에 대하여 한번 호출된다 .19 행의 신호 description() 은 매개 건치기 
의 설명을 생성한다 . 

KeyboardSensor 

1 /* keyboardsensor.cpp */ 

2 #include <qstring.h> 

3 #include <ctype.h> 

4 #include "keyboardsensor.h” 

5 

6 KeyboardSensor::KeyboardSensor(QWidget ^parent, 

7 const char *name) : QWidget(parent,name) 

8{ 

9 setFocusPolicy(QWidget: : StrongFocus); 

10 setMinimumSize(300,300); 

11 } 

12 void KeyboardSensor: :keyPressEvent(QKeyEvent * event) 

13 { 
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14 emitDescription(QString("P : "),event); 

15} 

16 void KeyboardSensor: :keyReleaseEvent(QKeyE vent * event) 

17 { 

18 emitDescription(QString( M R:"),event); 

19} 

20 void KeyboardSensor::emitDescription( 

21 const QString &typeStr,QKeyEvent *event) 

22 { 

23 int key = event->key(); 

24 int ascii = event->ascii(); 

25 ButtonState state = event->state(); 

26 

27 QString keyStr = QString( M % 1 M ).arg(key); 

28 

29 QString charStr = QString(""); 

30 if(key = Key Control) { 

31 charStr += QString( M Control n )； 

32 } else if(key == Key Alt) { 

33 charStr += QString( M Alt M )； 

34 } else if(key == Key_Shift) { 

35 charStr += QString( M Shift ")； 

36 } else { 

37 if(state & ControlButton) 

38 charStr+= 

39 if(state & AltButton) 

40 charStr+= "Alt-"; 

41 if(state & ShiftButton) 

42 charStr+= "Shft-"; 

43 if(isgraph(ascii)) 

44 charStr += ascii + QString(" "); 

45 else if(state & ControlButton) 

46 charStr += (ascii + 64) + QString(""); 

47 } 


48 
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49 if(event->isAutoRepeat()) 

50 charStr +« " repeat"; 

51 

52 QString str = QString("% 1 %2 %3") 

53 .arg(typeS 仕 ) .arg(keyS 仕 ) .arg(charS 仕 ); 

54 

55 emit description(s 仕 ); 

56} 

임의의 시각에 현시기우의 1 개 창문만 건반초점을 가지 며 입 력된 건치기는 그 1 개 창 
문으로만 간다 . 일부 창문은 초점을 받아들일수 있고 다른 창문들은 그렇지 못하다 . 6 행의 
구성자는 이 창문부품이 건반초점을 받아들이게 하는 방법을 지정하기 위해 setFocusPolicy() 
를 호출한다 . 기정으로 창문부품은 건반초점을 받아들이지 않는다 . 표 8-2 는 가능한 초점환 
경 설 정 을 설 명한다 . 

표 8-2. 초점방식을 조종하는 설정 


이름 

설명 

ClickFocus 

마우스에 의해 선택되기만 하면 초점은 이 창문부품으로 옳긴다 . 

NoFocus 

이 창문부품은 초점을 받아들이지 않는다 . 

StrongFocus 

이 방식은 TabFocus 와 ClickFocus 의 결합이다 . 

TabFocus 

오직 Tab 건만이 한 창문부품에서 다른 창문부품으로 초점을 옮기는데 사용 

될수 있다 . 이것은 보통 대화칸에서 창문부품집합에 사용된다 . 

WheelFocus 

초점 은 TabFocus, ClickFocus, 또는 마우스바퀴 의 이 동을 사용하여 이 창문부 

품으로 변경될수 있다 . 


12 〜 19 행에서 메쏘드 keyPressEvent () 와 keyReleaseEvent () 는 기초클라스의 가상메쏘드들 
을 재정의하며 매개 건치기와 함께 호출된다 . 두 메쏘드는 QKeyEvent 객체를 넘겨받고 메쏘 
드 emitDescriptionC ) 에 넘기여 문자렬로 형식화한다 . 


20 행에서 시작하는 메쏘드 emitDescription () 은 QKeyEvent 로부터 자료를 꺼내서 설명문자 
렬을 가진 description () 신호를 발생시 킨 다 . 

매 개 건은 유일번호를 가지 고있다 . 유일 번호는 27 행 에서 key () 호출에 의해 QkeyEvent 로 
부터 얻어 진다 . 건 이 현시 가능한 ASCII 문자라면 건값은 그 ASCII 값과 같다 . 현시할수 없는 
건에는 더 큰 수가 할당된다 . 실례로 그림 8-7 에서 이미 본것처럼 Shift 건의 값은 4128, Alt 건 
은 4131 그리고 R 的 jm 건은 4100 이 다 . 

조건코드 (30 〜 35 행)는 건이 3 개 수식건중의 하나인가를 판단한다 . 그것이 아니면 37~ 
46 행 의 코드는 누르고있는 수식 자들을 렬거 하고 그다음 문자자체(현시할수 있다면)를 현시 
한다 . 문자를 현시할수 있다면 43 행의 시험은 참이다 . 그러나 Conttol 건을 누르고있으면 문자 
값자체는 수식된다(어떠한 Control 문자에 64 를 더하면 원래의 현시가눙한 문자가 나타난다 ). 




49 행은 Boolean 메쏘드 isAutoRepeat () 를 검사하여 건을 누르고있는가 판단하고 사건들을 자동 
적으로 생성한다 . 


요 약 

Qt 서고는 마우스와 건반으로부터 오는 자료의 처리를 간단화한다 . 사건들은 서술객체로 형 
식화되고 정확한 창문부품으로 발송된다 . 이 장은 다음과 같은 내용을 설명하였다 . 

•하드웨어에서의 사건과 응용프로그람에서의 메쏘드호출사이에는 직접관계가 있을수 

있다 . 

• 어떤 창문부품이나 이동과 마우스단추찰칵 모두에 대하여 마우스를 감시할수 있다 . 

• 마우스유표의 형 태 변경 은 자식창문이 그 자체 의 변화를 일으키 지 않으면 그 부모창 
문과 자식창문들 모두에 대 해서 만 형 태를 변경 한다 . 

• 건사건들은 모든 건누르기와 모든 건놓기때에 발생된다 . 

이 장은 사용자유표를 만드는데 요구되는 도형처리에 대하여 간단히 언급하였다 . 



제 9 장. 도형파일형식 


학습내용 

2가지 기본형식의 도형자료의 조작 
파일에 보관된 도형자료의 적재와 현시 
그림기호들을 가지는 단추와 표식자들의 만들기 
각이한 상태들을 표시하기 위하여 특수한 종류의 도형 
이 장은 주로 디스크파일들로부터 도형자료를 적재하여 현시하는 방법을 설명한다. 
KDE 는 많은 형식의 도형파일을 인식하고 읽을수 있다. 현시기에 나타나는 모든것은 
QWidget 로부터 계승되므로 하나의 창문을 가진다. 또한 창문을 가지는 모든 클라스는 창문 
안에 픽 스매 프(색 도형 )를 현시할수 있다. 

프로그람은 두 위치중 하나로부터 그 도형자료를 얻을수 있다. 그것은 디스크의 파일에 
여 러 형 식 들중 하나로 보관되 고 프로그람은 그다음 파일을 읽어 들이 고 자료를 내 부적 스매 프 
로 변경한다. 또한 도형파일의 내용을 자기 프로그람으로 직접 를파일할수 있도록 하기 위 
하여 C 원천코드로 변환하는 방법이 있다. 2가지 방법은 같은것 즉 창문을 도색하는데 쓰이 
는 QPixmap 객체에 의거한다. 


제1절. 두 종류의 도형 

2가지 기본종류의 도형은 비트매프와 픽스매프이다. 

• 픽스매프는 화소값들의 직4각형배렬이다. 배렬에서 매개 값은 1개 화소의 색을 표시한다. 픽 
스매프는 임의의 시간에 자기 조색판에 적재할 때와 같이 많은 색을 담을수 있다. 

• 비트매프는 1개 화소에 매개 비트가 대응하는 비트들의 직4각형배렬이다. 비트매프는 
2가지 색만 가지고있다. 즉 매개 화소는 on 또는 off 이다. 보통 이것은 흑백색으로 현시되지만 
KDE 는 임의의 두 색을 사용하여 비트매프를 현시할수 있다. 비트매프는 실제로 픽스매프의 
특수한 경우이지만 그것은 흔히 그자체의 특수한 파일형식으로 사용된다. 

도형파일형식은 끝없이 많다. universal 변환프로그람에 의거 하면 임의의 도형 파일형식이라도 
KDE 응용프로그람에서 사용할수 있다. convert 편의프로그람(이 장에서 후에 자세히 설명)은 도형파 
일을 외부형식으로부터 현시가능한 형식으로 변환할수 있다. 실례로 다음 지령은 JPEG 파일을 프로 
그람으로 직접 콤파일할수 있는 형식인 픽스매프로 변환하는 방법을 보여준다. 

convert rickrack.jpeg rickrack.xpm 

프로그람에 비트매프(흑백색)를 포함하려면 다음과 같이 변환할수 있다. 

convert rickrack.jpeg rickrack.xbm 

convert 편의프로그람은 입력파일의 내용을 보고 그것이 어떤 종류의 파일인가를 결정하 
고(그것은 입력에서 파일확장자에 의거하지 않는다) 출력파일이름의 확장자를 보고 어떤 종 
류의 도형 파일을 생 성 하는가 결정한다. 




제 2 절. XPM 형식 


XPM ( XPixMap ) 도형형 식 은 ASCII 본문으로 도형 을 보관하기 위한 XII 표준이 다. 이 형 식 
은 문서 편집 기 를 사용하여 간단한 색도형 을 만들거 나 변경할수 있게 한다. XPM 정 의 는 
ASCII 일뿐아니라 그 형식은 직접 자기 프로그람으로 콤파일할수 있는 C 원천코드이다. 

다음은 4색 을 가지 는 XPM 도형 의 실 례 이 다. 

1 /* XPM */ 

2 /** essPixmap.xpm **/ 

3 static const char * essPixmap [] 데 

4 "12 14 4 1", 

5 " c None", 

6 "X c #FFFFFF", 

7 "R c Red", 

8 "B c #0000FF", 

9 " RRBB ", 

10 "XXXXXXXXXXXX", 

11 "XXXXXXXXXXXX", 

12 "XX RRBB ", 

13 "XX RRBB ", 

14 "XX RRBB ", 

15 "XXXXXXXXXXXX", 

16 "XXXXXXXXXXXX", 

17 " RRBB XX", 

18 " RRBB XX", 

19 " RRBB XX", 

20 "XXXXXXXXXXXX", 

21 "XXXXXXXXXXXX", 

22 " RRBB ", 

23}; 

XPM 파일의 문법 은 문자렬들의 배렬로서 정 의 된다. 첫 행의 설명 문은 편의 프로그람들 
이 파일형을 결정하는데 그것을 사용하므로 반드시 있어야 한다. 

4행은 뒤에 오는 자료를 설명하는데 사용되는 4개 수를 포함한다. 첫째 수는 픽스매프 
가 12화소너비라는것을 서술하며 둘째 수는 그것이 14화소 높이라는것을 서술한다. 다음 수 
는 4개 색 이 도형 을 그리 는데 사용된 다는것 을 지 정한다. 

마지 막 수자는 한개 문자를 매 개 색 의 표식 자로 사용한다는것 을 지 정한다. 







5 〜 9 행은 색정의이다. 매개 문자렬은 색을 식별하는 표식자로 쓰이는 문자로 시작한다. 

어떠 한 ASCII 문자든 사용할수 있다. 5행은 None 이 라는 이름으로 공백문자를 정의 한다. 
이것은 어떤 화소도 색칠하지 않는다는것을 지정하며 배경을 다시 쓰지 않으므로 투명색을 
생 성 한다. 6행 은 문자 표에 흰색의 값을 지 정 한다. 16진수값 FFFFFF 는 흰색 용의 적 록청 값이 다 
C 10 진수일 때 값들은 255 255 255이다). 8행은 문자 B 에 청색을 지정하는데 16진수값 0000 FF 
를 사용한다. 7행은 문자 모의 색을 정의하는데 어떤 이름을 사용한다. 그 이름은 파일 
/ usr / XllR 6/ lib / Xll / rgb.txt 에 있는 RGB 이 름들중의 하나이 여야 한다. 

도형자체는 9행에서 시작하고 22행에서 끝난다. 도형의 너비가 12화소이므로 매개 문자 
렬의 너비는 12화소이며 화소를 표시하는데 오직 1문자가 사용된다. 도형의 높이가 14화소 
이므로 이런 문자렬이 14개 있다. 매개 화소는 초기에 정의된 4색문자들중 하나를 포함하여 
값을 할당한다. 

XPM 파일은 많은 색을 가지는 큰 고분해능화상들을 표시하는데 사용될수 있다. 실례로 
Linux 배포물에는 Linux 펭긴새를 포함하는 logo.gif 라는 파일이 있다. 다음 지령으로 GIF 파일 
을 XPM 파일로 바꿀수 있다. 

convert logo.gif logo.xpm 

그때 생기 는 XPM 파일 에서 24 bit 이상의 색정 보가 포함되는데 이 것은 단일문자로 표시할 
수 있는것이상 많은 색이 있다는것을 의미한다. 전체 XPM 파일은 560행이다. 여기에서 발취 
한것이 있다. 

/* XPM */ 

static const char * magick [] = { 

"257 303 251 2", 

" c GrayO", 
c #080800000404", 

"X c #080808080000", 

"o c Gray3", 

"0 c #101004040404", 

"+ c #101010100404", 

c #f0f0b8b80808", 
c #f8f8b0b00808", 

"I. c #f8f8b8b80808", 

" X c #f0f0b0b01010", 

".X c #f0f0b8b81010", 

"XX c #f8f8b8b81010", 

"BX c #d8d8d8d8e8e8", 







"VX c #e0e0e0e0d8d8", 

"CX c #f0f0e8e8d8d8", 

"ZX c Gray88", 

"AX c Gray91", 

"SX c #e8e8e8e8fOfO", 

"DX c #fOfOe8e8ecec" f 
"FX c #fOfOfOfOe8e8", 

"GX c Gray94", 

"HX c #f8f8f8f8f8f8", 

"JX c None", 

이 XPM 도형은 257 x 303 화소크기이다. 그것은 모두 251개 색을 포함하며 매개 색을 표 
시 하는데 2문자를 리 용한다. 처 음 몇개 문자들은 단일문자에 의해 정의 되 는것 같지 만 사실 
상 공백이 둘째 문자로 되므로 2문자 리용한다. 파일을 설명하는 부분에서 볼수 있는것처럼 
종지부와 X 문자가 사용된다. 색을 정의하는데 2문자 요구되므로 화소값의 행을 정의하는 매 
개 문자렬은 514개 문자 (257 의 두배:)를 가져야 한다. 

또한 색들의 16진수는 6개가 아니라 12개 수자를 가지고있다. 이것은 여전히 RGB 형식 
이지만 매개 색은 16 bit (4 개 16진수：)이다. 어느쪽이든 길이는 XPM 파일에 유효하다. 그것을 
읽어들이는 쏘프트웨어는 형식을 결정하기 위한 수자들을 계수한다. 파일 
/ usr / XllR 6/ lib / Xll / rgb . txt 안의 색들과 다른 곳에서 찾은 많은 색들은 3개의 8 bit 값으로 정의된 
다. 다음의 간단한 프로그람은 3개의 8 bit 값들을 XPM 에서 요구되는 long 과 short 16진문자렬 
들로 변환한다. 

/* hexcolor */ 

#include < stdio . h > 

#include < stdlib . h > 
char * usage [] = { 

’’ Usage : hexcolor r g b ", 

’’ Enter the three RBG color values in the ”, 

" range of 0 to 256. The output is both a ", 

’’ 24 -bit and 48 -bit hexadecimal number of the ”, 

’’ color that can be used in an XPM file .’’ 

}； 

int main(int argc’char * argv []) 







int r , g , b ; 
if(argc < 4) { 
for ( i =0; i <5; i ++) 

printf ("% s \ n "， usage [ i ]); 

exit ( l ); 

} 

r = atoi ( argv [ l ]); 
g = atoi ( argv [2]); 
b = atoi ( argv [3]); 

printf ("#%02 X %02 X %02 XW ，， r , g , b ); 

printf ( n #%02 X 00%02 X 00%02 X 00\ n M , r , g , b ); 

exit ( O ); 


제 3 절. 자료로부터 XPM 의 표시 

사실상 convert 편의프로그람은 임의의 도형파일을 XPM 파일로 변환할수 있고 XPM 형식이 C 
원천코드이므로 어떠한 도형이라도 자기 프로그람으로 직접 콤파일할수 있다. 이것은 대체로 그 
림기호, 단추표식자，목록항목 그리고 다른 작은 장식항목들에 사용된다. 

알아두기: convert 편의프로그람은 C ++ 가 아니라 C 로 화상자료를 변환한다. 실제로 프 
로그탐내에서 QPixmap 를 만들려면 XPM 파일을 사용하기전에 제일 웃행을 편집하여 
이 름선 언에 const 변경 자를 삽입해 야 한다. const 없이 도 제대로 콤파일되 지 만 QPixmap 구 
성자는 그것이 const 가 아니라고 통보한다. 그리고 프로그람에서 하나이상의 XPM 파일 
을 사용하려고 한다면 항상 convert 가 그것을 magick 라고 이름을 붙이므로 배렬에 새 
로 이름을 붙여야 한다. 

다음의 프로그람은 XPM 파일을 직접 콤파일하여 현시하는 실례이다. 

1 /* showxpmxpp */ 

2 #include < kapplication . h > 

3 #include < qwidget . h > 

4 #include < qpixmap . h > 

5 

6 #include n logo . xpm " 

7 

8 int main(int argc , char ** argv ) 

9{ 

10 KApplication app ( argc , argv , " showxpm "); 
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11 QPixmap pixmap ( magick ); 

12 QWidget *widget = new QWidget (); 

13 widget -> setFixedSize ( pixmap . width (), pixmap . height ()); 

14 widget -> setBackgroundPixmap ( pixmap ); 

15 widget -> show (); 

16 app . setMain Widget ( widget ); 

17 return ( app . exec ()); 

18} 

6 행의 #include 문은 XPM 자료가 프로그람으로 직접 콤파일되게 한다. 11행은 XPM 자료로 
부터 QPixmap 를 만든다. 

어떠한 창문부품라도 그 배경색으로서 적스매프를 현시하는데 사용될수 있으므로 이 
실례에서 일반창문부품은 12행에서 만들어진다. 13행의 setFixedSizeO 호출은 창문부품이 픽스 
매프와 꼭같은 크기로 되게 한다. 14행의 setBackgroundPixmapO 호출은 창문부품에 픽스매프 
를 삽입한다. 결 과는 그림 9-1 에 보여 준다. 



그림 9-1. 콤파일된 XPM 자료의 현시 

고정크기로 창문을 설정하고 정확한 크기의 적스매프를 가지고있다면 전체 적스매프가 
표시된다. 창문부품의 창문이 적스매프보다 작다면 화상은 아래로，오른쪽으로 잘리운다. 창 
문이 픽스매프보다 크다면 적스매프는 창문이 가득 찰 때까지 타일형태로 붙여진다. 다음 
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실례는 더 작은 픽스매프(이 장에서 초기에 essPixmap 라고 이름지었다)를 사용하여 창문부품 
배경에 타일을 불인다. 

1 /* showxpmtile.cpp */ 

2 #include < kapplication . h > 

3 #include < qwidget . h > 

4 #include < qpixmap . h > 

5 

6 #include " essPixmap . xpm " 

7 

8 int main(int argc , char ** argv ) 

9{ 

10 KApplication app ( argc , argv , " showxpmtile "); 

11 QPixmap pixmap ( essPixmap ); 

12 QWidget *widget = new QWidget (); 

13 widget -> setBackgroundPixmap ( pixmap ); 

14 widget -> resize (200,100); 

15 widget -> show (); 

16 app . setMain Widget ( widget ); 

17 return ( app . exec ()); 

18} 

이 실례는 6 행에서 원천에 포함된 XPM 자료로부터 작은 픽스매프를 만든다. 적스매프 
의 실제크기를 무시하고 그것이 13행에서 배경픽스매프로서 설정되며 창문부품의 크기는 14 
행에서 설정된다. 결과는 그림 9-2 에 보여주는 창문이다. 



그림 9-2. 를파일된 XPM 자료를 타일배경으로 현시 














제 4 절 . 파일로부터 픽스매프의 적재 

이전의 실례를 약간 변경함으로써 도형을 프로그람의 부분으로서 콤파일하지 않고 파 
일로부터 실을수 있다. 필요한것은 다른 방법으로 픽스매프를 만드는것이다. 다음의 프로그 
람은 이 미 그림 9-1 에 서 보여 준 logo 픽 스매 프를 적 재 하고 현시한다. 

1 /* showfilexpmxpp */ 

2 #include <kapplication.h> 

3 #include <qwidget.h> 

4 #include <qpixmap.h> 

5 

6 int main(int argc, char **argv) 

7{ 

8 KApplication app(argc, argv, "showfilexpm"); 

9 QPixmap pixmap("logo.xpm’’); 

10 QWidget * widget = new QWidget(); 

11 widget->setFixedSize(pixmap.width(),pixmap.height()); 

12 widget->setBackgroundPixmap(pixmap); 

13 widget->show(); 

14 app. setMainW idget(widget); 

15 return (app.exec()); 

16} 

9 행에서 QPixmap 구성자는 도형자료의 위치를 파일을 사용하여 지정한다. XPM 이외의 
파일형들을 사용할수 있다. 실례로 각이한 형의 파일을 싣기 위하여 다음과 같이 9 행에서 
파일 이 름을 변경한다. 

QPixmap pixmap(‘‘logo.gif’); 

쏘프트웨어 는 파일 이 름의 뒤 붙이 를 보지 않고 파일 형 을 결정한다. 그대신 에 파일선두의 
자료블로크를 싣고 그것을 검사하여 파일형 을 결정한다. 이 것은 문자렬 XPM 을 포함하는 설 
명문이 달린 문자렬이 XPM 파일의 선두에 있어야 하는 리유이다. 

쏘프트웨어 가 무효한 XPM 파일 이라고 통보한다면 그것 은 낡은 형 식 일수 있다. 파일을 
사용하려면 판번호가 3 이여야 한다. 다음과 같은 지령으로 변환한다. 

sxpm -nod oldform.xpm -o newform.xpm 

도형파일을 적재하려면 쏘프트웨어는 파일형식을 리해하여야 한다. Qt 쏘프트웨어는 파 
일 형 으로서 PNG, BMP, GIF, JPEG, XBM, XPM 그리 고 PNM 을 제 공한다. Qt 쏘프트웨 어 는 후에 
다른 형식을 포함하도록 확장할수 있게 설계되였다. 

여 러가지 파일형식들로부터 읽어들이는데 특별히 요구되는것은 없다. 다음의 실례프로 
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그람은 그림 9-1 에 이미 보여주는 JPEG 판의 도형을 적재하고 현시한다. 
/* showfilejpeg.cpp */ 

#include < kapplication . h > 

#include < qwidget . h > 

#include < qpixmap . h > 

int main(int argc , char ** argv ) 

{ 

KApplication app ( argc , argv , " showfilejpeg "); 

QPixmap pixmap (" logo . jpeg "); 

QWidget * widget = new QWidget (); 

widget -> setFixedSize ( pixmap . width (), pixmap . height ()); 

widget -> setBackgroundPixmap ( pixmap ); 

widget -> show (); 

app . setMainWidget ( widget ); 

retum ( app . exec ()); 

} 


제 5 절 . 픽스매프를 리용한 단추의 장식 

단추는 다른 창문부품처럼 창문을 포함하므로 그것은 본문뿐아니라 그림을 현시할수 
있 다. 사실상 QPushButton 클라스는 픽 스매프가 단추의 현재상태를 표시 하도록 하는 몇가지 
특별한 확장기능을 가지고있다. 다음 프로그람은 PNG 파일을 사용하여 그림 9-3 에 보여준 단 
추의 앞면을 칠한다. 

1 /* decobutton.cpp */ 

2 #include < kapplication . h > 

3 #include < kpixmap . h > 

4 #include " decobutton . h " 

5 

6 int main(int argc , char ** argv ) 

V{ 

8 KApplication app ( argc , argv , ’’ decobutton "); 

9 DecoButton decobutton ; 

10 decobutton . show (); 

11 app . setMainWidget (& decobutton ); 

12 return ( app . execQ ); 


13 
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4 

5 DecoButton : : DecoButton(QWidget ^ parent,const char * name ) 

6 : QWidget ( parent , name ) 

7{ 

8 setFixedSize (200,150); 


20 QPixmap pixmap (" hil - app - go . png "); 

21 button = new QPushButton ( this ); 

22 button -> setPixmap ( pixmap ); 

23 button -> setGeometry (50,50,100,50); 
24} 



그림 9-3. 본문대신 도형을 가지는 단추 

제 일 웃준위창문에 사용한 창문부품은 DecoButton 이 다. 구성 자는 15행 에서 시 작한다. 18 
행은 200 X 150 화소의 고정크기로 창문부품을 설정한다. 

픽스매프는 20행에서 hil - app - go.png 라는 파일로부터 만들어진다. 단추가 만들어지고 픽 
스매프는 22행에서 setPixmap () 호출에 의해 안에 삽입된다. 23행에서 단추는 이 적스매프에 
알맞는 크기가 설정된다. 

QPushButton 클라스는 단추를 누를 때 특별한 일을 한다. 단추가 눌러운것으로 보이도록 
하기 위하여 배경은 더 어두운 색으로 바뀌고 도형 그자체는 1화소 아래로，1화소 오른쪽으 
로 옮겨진다. 결과는 그림 9-4 에 보여준다. 



그림 9-4. 본문대신에 도형으로 능동화된 단추 
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단추가 능동으로 될 때 그림기호에 의해 가리우지 않은 구역은 흐려진다. 그림기호는 
실제로 바른4각형이 므로 도형 자체안의 일부 화소들을 흐리게 하기 위하여 도형을 투명 색으 
로 하여야 한다. 단추를 선택할 때 색을 변경하는 투명색화소들은 사용자에게 좋은 효과를 
준다. 그러나 그림기호 자체의 도형이 수정되였다는것은 그림 9-3 과 그림 9-4 를 비교하여야 
만 알수 있다. 이 장에서 후에 서술하는 QlconSet 클라스에서 다른 방법을 고찰한다. 

제6절. XBM 형식 

2개 색 (보통 흑색과 백색)만 있으면 XBM ( XBitMap ) 형식으로 매개 화소에 lbit 를 가진 
그림을 보관하는것이 더 효과적이다. XBM 형식은 보통 마우스와 건반유표를 정의하는데 사 
용되지만 또한 다른 목적도 가지고있다 . XPM 형식처럼 XBM 파일은 C 프로그람으로 직접 를파 
일할수 있는 ASCII 파일 이다. 다음은 XBM 파일형식의 실례 이 다. 

#define arrow width 16 

#define arrow_height 16 

#define arrowxhot 15 

#define arrow _ y_hot 7 

static unsigned char arrow _ bits [] = { 

0 x 00, 0 x 00, 0 x 00, 0 x 00, OxcO , 0 x 07, 0 x 80, OxOf , 0 x 80, 

Oxlf , Oxfc , 0 x 3 f , Oxfc , 0 x 7 f , Oxfc , Oxff , Oxfc , 0 x 7 f , 

Oxfc , 0 x 3 f , 0 x 80, Ox If , 0 x 80, OxOf , OxcO , 0 x 07, 0 x 00， 

0 x 00, 0 x 00, 0 x 00, 0 x 00, 0 x 00}; 

처음 두 행은 화소로 너비와 높이를 결정한다. 다음 두 행은 열점의 자리표를 지정한다. 
열 점 은 비 트매 프가 마우스유표로 사용할 때 마우스위 치 로 리용되 는 비 트매 프 안의 정 확한 X 
와 y 화소위치이다. 열점의 지정은 자유이므로 두 행을 생략할수 있다. 그림 9-5 는 비트매프 
의 모양을 보여준다. 열점은 오른쪽 화살의 끝점에 있다. 

□ 

그림 9-5. 흑색과 백색의 도형을 정의하는 비트매프 
비트설정은 파일에서 바이트값으로 씌여지며 매개 수는 8개 화소의 on 또는 o 伴상태를 
지정한다. 화소들은 처음에 왼쪽에서 오른쪽으로，그다음 우에서 아래로 사영된다. 그것들은 
모두 하나의 배 렬에 보관되므로 그것을 사용하는 쏘프트웨어는 선분들이 끝나는곳을 알기 
위하여 높이와 너비정보를 가지고 있어야 한다. 


제 7 절 . 비프매프편의프로그람 

비트매프파일들을 만들고 그것들을 수정하는데 사용할수 있는 편의프로그람이 있다. 
16 x 16 의 기정크기를 가지는 새 비트매프를 만들 때에는 인수없이 지령이름을 입력한다. 
24 x 32 화소크기의 새 비트매프를 만들려고 한다면 다음과 같이 지 령을 입 력한다. 
bitmap -size 24 x 32 

일단 비트매프가 디스크에 만들어지고 써넣은 다음 편집하려면 지령행에서 다음과 같 
이 입 력하여 적재하고 편집할수 있다. 
bitmap arrow.xbm 

화살편집에 사용된 창문을 그림 9-6 에 보여준다. 

조종단추들의 배렬로부터 알수 있는것처 럼 그림 을 편집 하는 방법 은 많다. 그림 배치는 
오른쪽 살창에 현시 되 고 왼쪽마우스단추를 사용하여 화소값을 0으로 설 정할수 있고 오른쪽 
마우스단추로 그것 들을 1로 설정할수 있다. 오른쪽의 다이 야몬드모양화소는 열점 를 가러 키 
며 1개 열점만 있을수 있다. 열점을 설정하기 위하여 Set Hot Spot 단추를 누른 다음 화소를 
선택 한다. 


파일© 편집(日 보기00 화상0 설정 ( S ) 도움말世) 


Q I 많 月 e — 때 처/목; 


100( 松 ▼ 


■ ■BMJB B 


HAI i 4 세] O 八， 
沙 久 ♦好田的凡 



선액 (4 각형): 노 


16x16 24bpp 1000% 


그림 9-6. arrow . xbm 을 적재한 비트매프편집기 


















비트매프편의프로그람은 유표를 만드는데 쓰인다. 유표는 2개 비트매프를 요구하는데 
하나는 유표용, 다른 하나는 마스크용이다. 유표를 만드는 과정은 8장에서 설명하였다. 
알아두기: 이 프로그람은 표준 XII 배포물의 한 부분이다. 단추들과 차림표표식자들은 
이 프로그람이 전혀 다른 창문부품과 편의프로그람들을 리용하여 개발된것이므로 
KDE 의것들과 완전히 다르다. 기초로 하고있는 XII 표준과 규약원안은 전혀 다른 쏘프 
트웨어 에 기초하는 모든 프로그람들을 동시 에 갈은 현시기 에서 실행할수 있게 한다. 


제 8 절 . 차림표와 도구띠용으로 도형을 사용자정의하기 

도구띠의 그림기호는 항목을 사용할수 없거나 또는 도구띠단추 창문부품이 현재 사용 
자에 의해 마우스단추로 선택되였다는것을 보여주기 위하여 변경할수 있다. 단추의 상태를 
보여 주기 위 하여 픽스매프의 형 태를 변경할 필요가 있다. 그러 기 위 하여 QlconSet 클라스는 
하나의 QPixmap 를 입 력 으로 받아들이 고 2개 의 다른 크기 로 3개 적 스매 프를 생 성 한다. 6개 의 
픽 스매 프는 6장에 서 설 명한것 처 럼 도구띠 와 차림 표에 서 사용될수 있다. 

다음 실례프로그람은 그림 9-7 과 같이 도형파일의 선택과 그 도형의 6가지 각이한 형식 
을 현시한다. 5장에서 설명한 QFileDialog 는 도형 파일로부터 QPixmap 를 선택하고 적재하는데 
사용된다. 그때 QlconSet 객체는 그림에 보여준 적스매프의 6개 판을 만드는데 사용된다. 



그림 9-7. 6개의 각이한 형식의 그림기 호 

Setlcon 머 리 부파일 
1 /* seticon.h */ 

2# ifndefSETIC 0 N_H 

3 #defme SETICON_H 

4 

5 #include < qwidget . h > 

6 #include < qlayout . h > 







7 #include < qlabel . h > 

8 #include < qpixmap . h > 

9 #include < qpushbutton . h > 

10 

11 class Setlcon : public QWidget 

12 { 

13 Q_OBJECT 

14 public : 

15 SetIcon(QWidget * parent =0 ,const char * name =0); 

16 private : 

17 QVBoxLayout * makeVerticalBox (); 

18 QGridLayout * makeGrid (); 

19 void insertNewPixmap (); 

20 private : 

21 QPixmap pixmap ; 

22 QString pixmapName ; 

23 QPushButton ^ button ; 

24 QLabel * picLabel ; 

25 QLabel * nameLabel ; 

26 QLabel * normal ; 

27 QLabel * disabled ; 

28 QLabel * active ; 

29 QLabel * small ; 

30 QLabel * large ; 

31 QLabel * normalSmall ; 

32 QLabel * normalLarge ; 

33 QLabel * disabledSmall ; 

34 QLabel * disabledLarge ; 

35 QLabel * activeSmall ; 

36 QLabel * activeLarge ; 

37 public slots : 

38 void newPixmap (); 

39}; 

40 


41 #endif 
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17 〜 19 행에서 3개의 내부메쏘드들이 선언된다. 메쏘드 makeVerticalBox () 와 makeGrid () 는 
최 상위창문을 배 치 하기 위 하여 구성 자에 서 사용한다. 메 쏘드 insertNewPixmap () 는 새 로운 
QPixmap 를 만들어 현시할 필요가 있을 때마다 호출된다. 

21행과 22행의 QPixmap 와 QString 은 현재 픽스매프와 그 이름을 보관한다. 

23〜36행에서 선언된 누름단추와 표식자들은 현시기에 나타나는것들이다. picLabel 과 
nameLabel 이 라는 표식 자들은 적재된후 수정 안된 픽 스매프와 파일 이 름을 현시 한다. 26〜30행 
의 표식자들은 그림 9-7 에 보여준 표를 설명하는데 사용되며 31〜36행의 표식자들은 픽스매 
프의 6개 판의 매개를 현시하는데 사용된다. 

Setlcon 

1 /* seticon.cpp */ 

2 #include < kapplication . h > 

3 #include < qfiledialog . h > 

4 #include n seticon . h M 

5 

6 int main(int argc , char ** argv ) 

V { 

8 KApplication app ( argc , argv , " seticon "); 

9 Setlcon seticon ; 

10 seticon . show (); 

11 app . setMainWidget (& seticon ); 

12 return ( app . exec ()); 

13} 

14 

15 Setlcon :: SetIcon(QWidget * parent,const char * name ) 

16 : QWidget ( parent , name ) 

17 { 

18 pixmapName = " hil - app - go . png "; 

19 pixmap = QPixmap ( pixmapName ); 

20 

21 QHBoxLayout *hbox = new QHBoxLayout ( this ,5); 

22 QVBoxLayout *vbox = makeVerticalBox (); 

23 hbox -> addLayout ( vbox ); 

24 hbox -> addSpacing (50); 

25 QGridLayout *grid = makeGrid (); 

26 hbox -> addLayout ( grid ); 


218 






27 hbox -> activate (); 

28 

29 insertN ewPixmap (); 

30 

31 connect ( button , SIGNAL ( clicked ()), 

32 this , SLOT ( newPixmap ())); 

33} 

34 

35 QVBoxLayout * Setlcon : : makeVerticalBox () 

36 { 

37 QVBoxLayout *vbox = new QVBoxLayout (5); 

38 

39 vbox -> addStretch ( l ); 

40 

41 button = new QPushButton ( M Select M , this ); 

42 button -> setFixedSize ( button -> sizeHint ()); 

43 vbox -> addWidget ( button ); 

44 

45 vbox -> addStretch ( l ); 

46 

47 picLabel = new QLabel ( , M ', this ); 

48 picLabel -> setAutoResize ( TRUE ); 

49 picLabel -> setAlignment(AlignHCenter | AlignVCenter ); 

50 vbox -> addWidget ( picLabel ); 

51 

52 nameLabel = new QLabel (""， this ); 

53 nameLabel -> setAutoResize ( TRUE ); 

54 nameLabel -> setAlignment(AlignHCenter | AlignVCenter ); 

55 vbox -> addWidget ( nameLabel ); 

56 

57 vbox -> addStretch ( 1); 

58 

59 return ( vbox ); 

60} 

61 QGridLayout * SetIcon: : makeGridQ 






62 { 

63 QGridLayout *grid = new QGridLayout(4,3 )； 

64 

65 normal = new QLabel( M Normal n ,this); 

66 grid->addWidget(normal, 1,0); 

67 disabled = new QLabel("Disabled M ,this); 

68 grid->addWidget(disabled,2,0); 

69 active = new QLabel( M Active M ,this); 

70 grid->addWidget(active,3,0); 

71 small = new QLabel(" Small",this); 

72 grid->addWidget(small,0,1); 

73 large = new QLabel("Large n ,this); 

74 grid->addWidget(large,0,2); 

75 

76 normalSmall = new QLabel(’"’,this); 

77 grid->addWidget(normalSmall, 1,1); 

78 normalLarge = new QLabel( ,M, ,this); 

79 grid->addWidget(normalLarge, 1,2); 

80 disabledSmall = new QLabel(’"’,this); 

81 grid->addWidget(disabledSmall,2,1); 

82 disabledLarge = new QLabel(’"’,this); 

83 grid->addWidget(disabledLarge,2,2); 

84 activeSmall = new QLabel( ,M, ,this); 

85 grid->addWidget(activeSmall,3,1 )； 

86 activeLarge = new QLabel("",this); 

87 grid->addWidget(activeLarge,3,2); 

88 

89 return (grid); 

90} 

91 void Setlcon: : insertNewPixmap() 

92 { 

93 picLabel->setPixmap(pixmap); 

94 nameLabel->setT ext(pixmapName); 

95 

96 QlconSet iconset(pixmap); 
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97 

98 QPixmap p; 

99 p = iconset.pixmap(QIconSet:: Small,QlconSet: : Normal); 

100 normalSmall->setPixmap(p); 

101 p = iconset.pixmap(QIconSet: : Large,QIconSet: : Normal); 

102 normalLarge->setPixmap(p); 

103 

104 p = iconset.pixmap(QIconSet::Small,QIconSet::Disabled); 

105 disabledSmall->setPixmap(p); 

106 p = iconset.pixmap(QIconSet: :Large,QIconSet::Disabled); 

107 disabledLarge->setPixmap(p); 

108 

109 p = iconset.pixmap(QIconSet::Small,QlconSet: : Active); 

110 activeSmall->setPixmap(p); 

111 p = iconset.pixmap(QIconSet: : Large,QIconSet: : Active); 

112 activeLarge->setPixmap(p); 

113} 

114 void Setlcon: : newPixmap() 

115 { 

116 QString filter = "Icon (*.png *.xpm *.xbm)"; 

117 QString name = QFileDialog: : getOpenFileName( ,M ', 

118 filter,this); 

119 if(!name.isEmpty()) { 

120 int length = name.length() - name.findRev(V , ); 

121 pixmapName = name.right(length - 1); 

122 pixmap = QPixmap(name); 

123 insertN ewPixmap(); 

124 } 

125 } 

15 행의 선두에 Setlcon 창문부품의 구성자가 있고 11 행에서 응용프로그람의 최상위창문 
으로 사용된 다 . 18 행 과 19 행 은 초기 적 스매 프의 이 름과 값을 지 정한다 . 창문은 왼 쪽에 vbox 라 
는 QVBoxLayout, 오른쪽에 grid 라는 QGridLayout 를 포함하는 수평칸 hbox 로서 배치된다 . 22 
행과 25 행의 makeVerticalBoxO 와 makeGridO 호출은 수평칸에 포함된 2 개 보조배치를 만들어 
낸다 . 

29 행의 insertNewPixmap() 호출은 초기픽스매프를 현재 현시하려는것으로서 설치한다 . 31 
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행 의 connectO 호출은 단추를 누를 때 마다 처 리 부메 쏘드 newPixmap () 를 실 행 하도록 설 정한다. 

35행의 메쏘드 makeVerticaffioxO 는 Select 단추, 변경되지 않은 도형을 현시하기 위한 현 
시표식자 그리고 도형파일의 이름을 보관하는 표식자를 만든다. 이것들은 모두 수직칸에 삽 
입된다. 41〜43행에서 단추를 만들어서 삽입한다. 47〜55행에서 2개 표식자를 만들어 수직칸 
에 추가한다. 표식자들은 비여놓는데 픽스매프와 그 파일이름은 후에 설치된다. 61행에서 시 
작하는 메 쏘드 makeGrid () 는 현재 픽 스매 프의 여 러 가지 모양을 현시 하는데 쓰이 는 QLabel 객 
체들의 표를 만들기 위하여 QGridLayout 를 사용한다. 살창은 3><4세포 크기이다. 첫행과 첫렬 
은 그림 9-7 에서 창문의 오른쪽에서 볼수 있는것처럼 주석표식자들에 사용된다. 65〜74행에 
서는 본문을 리용하여 주석으로서 표식자들을 만든다. 76〜87행 에서 만든 표식자들은 픽스매 
프도형들을 현시하기 위 한것이므로 본문없이 만들어진다. 

91행에서 메쏘드 insertNewPixmapO 는 현시기에 현재 픽스매프정보를 채운다. 이 메쏘드 
는 프로그람이 처음 기동할 때 기정픽스매프를 설치하기 위 해서만 호출되 며 새 적스매프가 
선택될 때마다 다시 한번 호출된다. 

객체의 pixmap 마당에 보관된 픽스매프를 사용하여 96행에서 QlconSet 객체 iconset 을만든 
다. 지금 요구되는것은 6개의 수정된 픽스매프를 현시할 표식자창문부품들을 얻어서 삽입하 
는것 이 다. 메 쏘드 pixmapO 는 도형 의 매 개 판을 엄 는데 사용된 다. 메 쏘드에 넘어 오는 인 수는 
6개 중 어 느판을 돌려 주는가를 결 정한다. 첫 인 수는 돌려 주는 픽 스매 프가 Small 이 나 Large 라 
는것을 지 정 한다. 둘째 인수는 Normal , Disabled 이 나 Active 이 라는것을 지 정 한다. 인수값들은 
QlconSet 클라스에서 렬거형 으로 정 의 된다. 

선택한 픽스매프가 작은 그림기호와 꼭같은 크기이면 Small 판은 원래것과 다름없고 확 
장판은 Large 용으로 만들어 진 다. 다른 한편 픽 스매 프가 Large 그림 기 호와 같은 크기 이 면 
Small 그림기 호가 생성 된다. 크기 들은 절대크기 로 조절되 지 않고 도형 의 원래크기 에 관계된다. 
실례로 매우 큰 도형을 선택한다면 그 크기는 Large 그림기호용으로 변경되지 않고 오직 
Small 그림기호에 대해서만 축소된다. 

114행의 처리부메쏘드 newPixmapO 는 Select 단추를 찰칵할 때마다 호출된다. 그것은 117 
행에서 도형파일을 선택하기 위하여 getOpenFileNameO 호출에 의해 QfileDialog 를 펼친다. 116 
행 에서 정의한 려 과기 는 . png , .xpm 그리 고 . xbm 확장자를 가진 파일들로 제한하지 만 필요하 
다면 다른 도형파일들을 포함할수 있다. 파일이름이 선택된다면 그 완전경로이름이 되돌아 
온다. 120행의 QStting 의 메쏘드 findRevO 와 lengthQ 은 경로없이 파일이름의 길이를 결정하는 
데 사용되며 121행의 right () 호출은 현시하려는 파일의 이름을 꺼낸다. 122행에서 새로운 픽스 
매 프를 만들고 123행 에서 insertNewPixmapO 호출에 의해 새 로운 현시 가 구성 된다. 

요 약 

도형 처 리 에는 많은것 이 있으나 이 장에서는 차림 표와 도구띠 용 도형단추들을 만들수 
있는 충분한 정보를 설명하였다. 이 장에서는 다음과 갈은 내용을 설명하였다. 



• 도형의 2가지 기본형식은 비트매프와 픽스매프이다. 비트매프는 색정보를 담고있지 
않으며 매개 화소에 1 또는 0을 지정한다. 픽스매프는 임의의 색을 가질수 있다. 그리고 픽 
스매프 ( XPM 형식)와 비트매프 ( XBM 형식) 모두는 프로그람으로 직접 콤파일하거나 실행시에 
동적으로 적재할수 있다. 

• QWidget 를 계승하는 객체는 그 배경 에 고정색 이 아니 라 픽스매프를 현시할 능력을 
가지고있 다. 

• KDE 는 많은 도형 파일형 식 을 인식 하며 쏘프트웨어 는 다른것 들을 후에 추가할수 있도 
록 설계된다. 사실상 그것들을 공유서고에 추가하여 다시 를파일하지 않고 프로그람에서 사 
용할수 있다. 

이 장에서 소개된 픽스매프들은 보통 사용자에게 어느 단추가 무엇을 하는가를 알리는 
식 별자로 리 용된다. 그러 나 대체로 본문과만 작업한다. 다음 장은 응용프로그람에 사용할수 
있는 여러가지 서체와 서체묘사수법을 탐구한다. 




제 10 장. 서체 


학습내용 

서체의 크기를 설정하고 변경하는 방법 
xii 서체이름달기관례의 리해 
서체선택창문부품에 의한 서체선택 
서체측도정보의 읽기 

본문위치지 정 _ 

Xll , Qt 그리 고 KDE 에서 사용하는 서 체들은 처 음에 삭갈리 기 쉽다. 그러 나 일단 무엇 
을 하는가 알면 매우 간단하다. 매우 유연하고 직접적인 서체취급방법이 제안되였다. 응용프 
로그람에서는 자기가 특별히 좋아하는 서체를 정확히 사용할수 있다. 또한 서체선택에서 시 
간손실을 없앨수 있고 체계가 선택기준에 맞는 서체를 선택하도록 할수 있다. 또한 사용자 
가 서체를 선택할수 있는 2개의 창문부품이 있다. 

서체는 크기와 형태에 따라서 각이하다. 서체에 적용되는 특수한 측도들이 있다. 그 표 
준값들을 사용하여 현시기에 문자위치를 지정함으로써 모든 서체들을 갈은 방법으로 취급할 
수 있다. 이 장은 각이한 형과 크기의 서체의 얻기，위치지정 그리고 묘사방법을 론의한다. 

제 1 절 . 서체의 해부 

서 체 에서 한 문자 또는 한개 문자렬 에 대하여 수많은 측도를 설정할수 있다. 문제를 복 
잡하게 하는것은 일부 문자들이 다른 문자들보다 크고 일부는 다른 문자들보다 아래로 내려 
가며 일부 문자들은 다른 문자들보다 넓다는 사실이다. 또한 한 문자렬안에서 서로 린접문 
자들에서 한 문자가 다른 문자와 겹칠수 있으며 이것은 큰 문자의 웃끝이 오른쪽으로 늘어 
나는 경사체에서 일반적으로 볼수 있다. 

그림 10-1 에서는 문자를 구성하는 측도들을 보여준다. 원점은 문자를 그리는데 사용되 
는 x 와 y 자리표점 이 다. 다시 말하면 문자를 특정한 자리표점 에 그릴 때 실제 로 그것 은 그 
점의 오른쪽우에 나타난다. 다른 한편 문자 p 는 점의 오른쪽에 나타나지만 그 우와 아래에 
모두 나타난다. 문자의 화소묘사 또는 도형설계 를 도형문자설계(글리 프)라고 한다. 모든 글 
리프는 원점에 준하여 설계된다. 원점은 문자자체를 그리는데 필요하다. 이 원점들의 렬을 
기 준선 이라고 부른다. 상승값과 하강값들은 기 준선 으로부터 문자의 웃끝 그리 고 아래끝까지 
의 치수이다. 상승과 하강의 총합은 문자의 높이이다. 문자의 너비는 원점에서 문자의 오른 
변까지로 계산된다. 왼쪽위치 ( lbearing ) 는 원점에서 문자까지 거리이고 오른쪽위치 ( rbearing ) 는 
문자의 도형부분의 너비이다. 







제 2 절. 서체의 이름 

서체들은 디스크파일들에 보관된다. 서체파일들은 표준 x 배포물의 한 부분이다. 응용프 
로그람이 서체를 요구할 때 그것은 응용프로그람이 아니라 X 봉사기에서 파일형태로 적재된 
다. 서체들은 봉사기에 있으므로 현시를 위해 응용프로그람에서 봉사기에로 구체적인 서체 
정보의 넘기기로 인한 추가비용은 없다. 이 통신량감소는 다른 를퓨터의 응용프로그람에 의 
해 조종되는 국부 X 창문(국부봉사기에서；)을 여는것이 례사로운 일로 되여 있으므로 많은 시간 
을 절약할수 있다. 그밖에 2개이상의 응용프로그람이 같은 서체를 사용하고있다면 오직 한 
개 사본이 적재되여야 한다. 

서체파일들은 대체로 /usr/lib/Xl 1/fonts 의 보조등록부에 보관된다. 매개 보조등록부에 있 
는 서체파일들은 확장자 .pcf 또는 .pcf.gz 를 가진다. 서체들과 함께 갈은 등록부에는 별명이 
름들을 실제서체파일이름들로 넘 기는 fonts.dir 라는 파일 이 있다. fonts.dir 에서 정의한 서체들 
에 별명을 할당하는데 쓰이는 fonts.alias 도 있다. 실례로 다음과 같이 그 이름을 지정함으로 
써 10x20.pcf.gz 라는 서체파일을 사용할수 있다. 

10x20 

혹은 그것에 할당된 별명을 사용할수 있다. 즉 
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간략형식은 기억하기 쉽고 긴 형식은 리해하기 쉽다. 그리고 쏘프트웨어는 이름의 매개 
부분에 대리기호들을 사용하여 선택할수 있게 한다. 이름의 매개 부분은 특별한 의미를 가 
진 다. 표 10-1 은 그림 m -3 에 보여 준 이 름의 매 개 요소들을 설 명한다. 


서체！]I작자 서체계_ 

/ / 

-adobe-courier-bold 

무게 

그림 10-3. 서 체이름의 요소들 


표 10-1. 서체이름의 요소 
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부분이름 

설명 


미한다)일 수 있 다. 

비 례 너 비 

높이와 너비사이의 관계는 대체로 표준이지만 그것은 응축，반응축되거나， 

좁아지거나 배로 늘일수 있다. 

화소 

화소단위의 서체크기. 보통 서체크기는 점으로 측정된다. (점은 lin 의 1/72 
이다.；) 화소크기값을 얻기 위하여 점크기를 화소크기로 변환한다. 이것은 

점 크기 가 화소경 계 를 벗 어나므로 잘리 울수 있 다는것 을 의 미한다. 

점 

1/10 점단위의 서체의 점크기. 실례 에서 값 80 은 이것 이 8 점서체 라는것을 
가리킨다. 점크기와 화소크기사이의 관계는 수직 및 수평 dpi(in 당 점수：)값 
들에 의해 결정 된다. 이 실례 에서 100dpi 에서 8 점서 체는 11 의 화소크기 를 
가지고있다. 같은 dpi 에서 12 점 서체는 17 의 화소크기를 가진다. 

수평 dpi 

분해능 lin 당 수평화소수. 이 값은 화소와 점크기를 계산하는데 사용된다. 
또한 서 체 현시 에 서 수평 수직 dpi 를 결정 하기 위 하여 수직 dpi 와의 비률로 사 

용된다. 

수직 dpi 

분해능 lin 당 수직화소수. 

간격 

이것은 m( 등폭서체)， p (비례서체) 또는 c( 문자세포)일수 있다. 등폭 
(monospace) 서 체는 모든 문자들의 너 비가 같은 서 체 이다. 비 례서 체는 각이 
한 너 비의 문자를 가진다. (실례로 글자 w 가 문자 i 보다 폭이 넓다.) 문자 

세포서 체는 타자기 서 체 에서 간격 유지 방법 에 기 초한 고정너 비서 체 이 다. 

화소너 비 

서 체안의 모든 문자들의 평 균너 비 (1/10 화소). 

문자모임 

이것은 문자모임을 정의하는데 사용되는 표준판이다. ISO 는 여러가지 언어 

의 자모에 포함되는 문자모임들에 대한 표준을 확립하였다. 


긴서체이름들은 설명을 줄뿐아니라 서체를 탐색할 때 대리문자들을 사용할수 있는 형 
식으로 되여있다. 이리하여 오직 주의할 점만 지정할 필요가 있고 그 나머지를 기정으로 한 
다. 실례로 


-*-bookman-light-r-normal—14-*-*-*-p-*-iso8859-l 

이름에서 지정된 부분들은 실제 서체와 정확히 일치해야 하며 별표는 임의의 값과 대 
조될수 있다. 여러개의 서체들이 대조되면 처음으로 대조되는것이 돌아온다. 앞의 실례는 이 
서체를 선택할수 있다. 

- adobe-bookman-light-r-normal—14-135-75-75-p-82-iso8859 -1 

서체이름을 지정할 때 오직 필요한 부분만 지정해야 한다. 그리하여 실제 서체이름과 
대조할 더 많은 기회를 준다. 서체의 지정이 서체이름과 일치하지 않으면 기정서체가 사용 


티는데 그것은 대체로 자기가 요구하는 서체가 아니다. 




제 3 절. 참문부품의 서체설정 

QFont 객체를 만들어 창문부품이 사용하는 서체를 지정하는데 사용할수 있다. 다음 실례 
는 3 개의 표식 자를 현시 하는데 그 매개는 그림 10-4 와 같이 각이한 서 체를 리 용한다. 

1 /* fontset.cpp */ 

2 #include <kapplication.h> 

3 #include <qlabel.h> 

4 #include <qlayout.h> 

5 #include <qfont.h> 

6 #include "fontset.h" 

7 

8 int main(int argc, char **argv) 

9{ 

10 KApplication app(argc, argv, "fontset"); 

11 FontSet fontset; 

12 fontset.show(); 

13 app.setMainWidget(&fontset); 

14 retum(app. exec()); 

15} 

16 FontSet: :FontSet(QWidget *parent,const char *name) 

17 : QWidget(parent,name) 

18 { 

19 QVBoxLayout *vbox = new QVBoxLayout(this, 10); 

20 

21 QLabel *labell = new QLabel( 

22 "Bold 14-point Courier",this); 

23 QFontfontl( M Courier M ,14,QFont::Bold,FALSE); 

24 label 1 ->setFont(font 1); 

25 vbox->addWidget(label 1); 

26 

27 QLabel *label2 = new QLabel( 

28 "20-point Fixed",this); 

29 QFontfont2( M Fixed n ,20,QFont::Normal,FALSE); 

30 label2 - >setFont(font2); 

31 vbox->addWidget(label2); 
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32 

33 QLabel *label3 = new QLabel( 

34 "Bold Italic 18-point Charter",this); 

35 QFont font3(“Charter” ， 18 ， QFont::Bold,TRUE); 

36 label3 - >setFont(font3); 

37 vbox->addWidget(label3); 

38} 



Bold 14-point Courier 


20-point Fixed 

Bold Italic 18 -point Charter 

그림 10-4. 표식자들에서 서체의 설정 

일단 QFont 객체가 만들어 지 면 setfontO 호출은 표식 자에 그것을 설치 한다 . setfontO 메쏘드 
는 QWidget 클라스를 계승하는 가상메쏘드이므로 갈은 방법은 본문을 현시하는 임의의 창문 
부품에 동작해야 한다 . 

QFont 구성자는 서체이름을 지정하는 인수목록을 받아들인다 . 인수들은 초기 에 지정한 
서체파일이름들과 같은 정보를 포함하지만 그것들은 형식을 리용하기 쉽게 되 여있다 . QFont 
를 만들려 면 서체계 렬이름 , 점크기 , 문자무게 그리고 서 체가 경사체 인가 아닌가를 지정해 야 
한다 . QFont 클라스에 서 렬 거 형 으로 정 의 되 는 무게 번 호는 Light, Normal, DemiBold, Bold 그리 고 
Black 이 다 . 

구성자에 넘기는 인수로서 실제로 존재하지 않는 서체 실례로 12 점고정경사체를 지정 
할수 있으나 구성자는 서체이름짓기관례 에 따라 요구하는 서체 에 가장 잘 일치하는것을 탐 
색 하므로 서 체 탐색 에 서 성 공한다 . QFont 구성 자코드를 작성 하기 전 에 이 장의 프로그람들중 하 
나를 사용하여 사용가능한 서체들을 열람할수 있다 . 

정확한 서체이름을 지정하려고 한다면 QFont 객체에 대하여 메쏘드 setRawNameO 를 사용할수 
있다 . 실례로 다음 코드는 Adobe 에서 만든 Utopia 계렬의 경사체인 QFont 객체를 만든다 . 

QFont font; 

font.setRawName( M -adobe-utopia-regular-i-normal~ 1 5-140-75-75-p-79-iso8859-l n ); 
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제 4 절. QFontDialog 에 의한 서체의 선택 

다음 프로그람은 QFontDialog 를 펼치는데 사용할수 있는 단추를 기본창문에 표시한다 . 대화 
칸에서 서체선택은 본문과 단추의 서체를 모두 바꾸게 하며 매개 서체설명은 그 서체자체에서 
제시된다 . 그림 m-5 에서 기본창문과 단추의 3 가지의 다른 형태를 보여준다 . 





그림 10-5. 단추에 현시된 3 가지 서체 

FontPrompt 머 리 부과 일 

1 /* fontprompt.h */ 

2 #ifndef FONTPROMPT_H 

3 #define FONTPROMPT_H 

4 

5 #include <qwidget.h> 

6 #include <qpushbutton.h> 

7 

8 class FontPrompt: public QWidget 

9{ 

10 Q_OBJECT 

11 public: 

12 FontPrompt(QWidget *parent=0,const char *name=0); 

13 private: 

14 QPushButton ^button; 

15 private slots: 

16 void popupDialog(); 

17 }； 

18 

19 #endif 
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FontPrompt 클라스는 매우 간단하다 . 그것은 찰칵해 야 할 단추와 대화칸을 펼치 기 위 해 
실행해야 할 처리부를 포함한다 . 

FontPrompt 

1 /* fontprompt.cpp */ 

2 #include <kapplication.h> 

3 #include <qfontdialog.h> 

4 #include "fontprompt 上 " 

5 

6 int main(int argc, char **argv) 

7{ 

8 KApplication app(argc, argv, "fontprompt"); 

9 FontPrompt fontprompt; 

10 fontprompt.show(); 

11 app. setMainWidget(&fontprompt); 

12 retum(app. exec()); 

13} 

14 FontPrompt :: FontPrompt(QWidget *parent,const char *name) 

15 : QWidget(parent,name) 

16 { 

17 button = new QPushButton( M,, ,this); 

18 QFont font = button->font(); 

19 button->setText(font.rawName()); 

20 button->setFixedSize(button->sizeHint()); 

21 setFixedSize(button->sizeHint()); 

22 

23 connect(button,SIGNAL(clicked()), 

24 this,SLOT(popupDialog())); 

25} 

26 void FontPrompt: : popupDialog() 

27 { 

28 bool okay; 

29 

30 QFont oldFont = button->font(); 

31 QFont newFont = 

32 QFontDialog: : getFont(&okay,oldFont,this); 




33 if(okay) { 

34 button->setFont(newF ont); 

35 button->setText(newFont.rawName()); 

36 button->setFixedSize(button->sizeHint()); 

37 setFixedSize(button->sizeHint()); 

38 } 

39} 

14 행 에 서 시 작하는 FontPrompt 구성 자는 기 본창문에 단추를 만들어 설치 한다 . 18 행 의 
fontO 호출은 단추의 현재 ( 기정)서체를 얻는다 . 19 행의 rawName () 호출은 서체의 완전이름을 얻 
고 setText () 를 호출하여 서 체 이름이 단추본문으로 사용되 도록 설정 한다 . 20 행은 setFixedSizeO 
를 호출하여 단추크기가 본문크기와 정확히 같아지게 한다 . 21 행의 setFixedSize () 호출은 단추 
에 적 합하게 기 본창문의 크기 를 설 정한다 . 

단추는 26 행에서 처리부메쏘드에 련결된다 . 기정본문을 보여주는 결과창문은 초기에 그 
림 10-5 의 꼭대기에 보여준것과 같다 . 

26 행의 popupDialogO 처리부메쏘드는 새로운 서체를 얻고 설치하는 모든 작업을 한다 . 
30 행의 fontO 호출은 단추로부터 현존서 체를 얻 는다 . 32 행의 getFont () 호출은 기정으로 리 용하 
는 현존서 체를 대화칸에 넘 긴다 . 기 정서 체 를 현시 하는 초기창문은 그림 10-6 에 보여 준것과 
갈다 . 



그림 10-6. 기정서체를 보여주는 서체선택 
























알아두기 : 대화칸에서 여러개의 선택항목이 표준서체정의의 요소로 포함되지 않는다 . 
취소선과 밑줄용 절환단추들은 QFont 클라스에 의해 추가된 2 개 서체선택들이므로 
대화칸의 부분이다 . 

0K 단추를 찰칵하면 31 행에서 새로운 서체가 newFont 로서 등록된다 . 또한 Boolean 변수 
okay 는 TRUE 로 설정 된다 . 34 행 에 현시 를 갱신하기 위 한 setFont() 호출이 있다 . seffont() 메 쏘드 
는 QWidget 클라스의 성원함수로서 선언되며 이것은 본문을 현시하는 창문부품의 본문을 설 
정 하는데 사용된 다는것 을 의 미한다 . 35 행 은 rawNameO 과 setText() 를 호출하여 단추에 새 로운 
서체의 완전서술을 삽입한다 . 36 행과 37 행은 서체변경이 늘 창문크기를 변경하므로 단추와 
창문의 크기를 조절할 필요가 있다 . 

제5절. KFontDialog 에 의한 서체의 선택 

다음의 서체선택프로그람은 KFontDialog 를 서체선택에 사용하는것을 제외하면 앞의 실 
례와 거의 같다 . 대화칸은 그림 10-7 에 보여준다 . 



그림 10-7. 서체선택대화칸 

FontPrompt2 머 리 부파 일 

1 /* fontprompt2.h */ 

2 #ifndef FONTPROMPT2_H 

3 #defme FONTPROMPT2 H 























5 #include <qwidget.h> 

6 #include <qpushbutton.h> 

7 

8 class FontPrompt2: public QWidget 

9{ 

10 Q_OBJECT 

11 public: 

12 FontPrompt2(QWidget *parent=0,const char *name=0); 

13 private: 

14 QPushButton ^button; 

15 private slots: 

16 void popupDialog(); 

17 }； 

18 

19 #endif 

FontPrompt2 

1 /* fontprompt2.cpp */ 

2 #include <kapplication.h> 

3 #include <kfontdialog.h> 

4 #include ’’fontprompt2.h" 

5 

6 int main(int argc, char **argv) 

7{ 

8 KApplication app(argc, argv, n fontprompt2"); 

9 FontPrompt2 fontprompt2; 

10 fontprompt2. show(); 

11 app.setMainWidget(&fontpromp 接 ); 

12 retum(app. exec()); 

13} 

14 FontPrompt2::FontPrompt2(QWidget *parent,const char *name) 

15 : QWidget(parent,name) 

16 { 

17 button = new QPushButton( ,M ',this); 

18 QFont font = button->font(); 




19 button->setText(font.rawName()); 

20 button->setFixedSize(button->sizeHint()); 

21 setFixedSize(button->sizeHint()); 

22 

23 connect(button,SIGNAL(clicked()), 

24 this,SLOT(popupDialog())); 

25} 

26 void FontPrompt2 :: popupDialog() 

27 { 

28 QFont font = button->font(); 

29 int result = KFontDialog: :getFont(font); 

30 if(result = QDialog::Accepted) { 

31 button->setFont(font); 

32 button->setText(font.rawName()); 

33 button->setFixedSize(button->sizeHint()); 

34 setFixedSize(button->sizeHint()); 

35 } 

36} 

14 행에서 시작하는 FontPrompt2 구성자는 한개 단추를 가진 창문을 만든다 . 단추의 모양 
은 18 행과 19 행에서 자기의 서체이름을 보여주기 위해 초기화된다 . 20 행과 21 행은 제일웃준 
위창문과 단추를 본문크기 로 조절 한다 . 

26 행의 처리부메쏘드 popupDialog() 는 단추를 찰칵할 때마다 호출된다 . 29 행의 정적메쏘 
드 getFont() 는 대화칸을 펼치고 선택하였으면 값 QDialog :: Accepted 를 돌려주며 혹은 선택하 
지 않았으면 QDialog :: Rejected 를 돌려준다 . 31 행과 32 행은 선택된 서체를 사용하도록 단추를 
갱신하고 단추의 본문을 서체의 설명이름으로 설정한다 . 32 행과 33 행은 단추와 창문을 본문 
에 알맞게 조절한다 . 

대화칸 KFontDialog 와 QFontDialog 는 아주 류사하다 . 차이점은 QFontDialog 는 2 개의 검 
사칸(밑선과 취소선)을 추가적으로 더 가지고있으며 KFontDialog 는 창문의 아래에 실례본문 
을 현시하는것이다 . 이것들은 모두 문자렬을 편집하여 사용하려는 본문에 어떤 서체가 좋은 
가를 알수 있게 하지만 KFontDialog 는 다만 본문을 초기화하여 프로그람에 돌려주게 한다 . 
그러기 위하여 다음과 같이 대화칸을 만든다 . 


int result = KfontDialog :: getFontAndText(font, btext); 

KfontDialog: : getF ont AndT ext(font, btext);. 

btext 인수는 OK 단추를 찰칵할 때마다 대화칸창문의 아래에 현시된 본문을 받아들이는 
QString 객 체 이 다 . 




제 6 절. 측도에 의한 서체배치 

측도값들은 창문에서 서체들을 배치하는데 사용할수 있다 . 다음 응용프로그람은 서체를 
선택하고 서체의 측도들로부터 계산된 위치에 현시되도록 한다 . 

그림 10-8 에서는 서체를 선택하고 본문위치를 지정하는데 쓰이는 단추들을 가진 프로그 



탐의 제 일웃준위창문을 보여 준다 . 제 일 우의 3 개의 단추는 검 은 직 4 각형안에 본문을 수직 방 
향으로 배치하며 아래에 있는 3 개 단추는 본문을 수평방향으로 배치한다 . 아래에 있는 큰 
단추는 그림 10-6 에서 보여준것처럼 대화칸을 펼친다 . 이 대화칸은 서체를 바꾸는데 사용할 
수 있다 . 


그림 10-8. 창문안에서 본문의 배치 

FontPaint 머 러 부파일 

1 /* fontpaint.h */ 

2 #ifndef FONTPAINT_H 

3 #defme FONTPAINT_H 

4 

5 #include <qwidget.h> 

6 #include <qframe.h> 

7 #include <qpushbutton.h> 

8 

9 class FontPaint: public QWidget 

10 { 

11 Q_OB JECT 

12 public: 







13 FontPaint(QWidget *parent=0,const char *name=0); 

14 private: 

15 void updateDisplay(); 

16 protected: 

17 void paintEvent(QPaintEvent *); 

18 private: 

19 enum { Hleft, Hcenter, Hright}; 

20 enum { Vtop, Vmiddle, Vbottom }; 

21 int Hposition; 

22 int Vposition; 

23 QPushButton *topButton; 

24 QPushButton *middleButton; 

25 QPushButton *bottomButton; 

26 QPushButton *leftButton; 

27 QPushButton *centerButton; 

28 QPushButton *rightButton; 

29 QPushButton *selectFontButton; 

30 QWidget * frame; 

31 QFont font; 

32 private slots: 

33 void popupDialog(); 

34 void setTop() { Vposition = Vtop; 

35 updateDisplay(); } 

36 void setMiddle() { Vposition = Vmiddle; 

37 updateDisplay(); } 

38 void setBottom() { Vposition = Vbottom; 

39 updateDisplay();} 

40 void setLeft() { Hposition = Hleft; 

41 updateDisplay();} 

42 void setCenter() { Hposition = Hcenter; 

43 updateDisplay();} 

44 void setRight() { Hposition = Hright; 

45 updateDisplay();} 

46}; 

47 
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48 #endif 

FontPaint 클라스는 최상위창문으로 사용되는 창문부품이다 . 19 〜 20 행의 렬거형들은 21- 
22 행에서 Hposition 과 Vposition 에 기억된 현재 상태를 가지고 본문의 수직 및 수평위치를 지 
정하는데 사용된다 . 23 〜 28 행에서 선언된 누름단추들은 각각 Vposition 과 Hposition 에 값을 보 
관한다 . 34 〜 45 행의 매개 처리부메쏘드들은 하나의 단추에 련결되며 메쏘드가 호출될 때 그 
것은 본문의 위치를 갱신하고 updateDisplayO 를 호출하여 창문을 그린다 . 

FontPaint 

1 /* fontpaint.cpp */ 

2 #include <kapplication.h> 

3 #include <qfontdialog.h> 

4 #include <qpainter.h> 

5 #include <qlayout.h> 

6 #include "fontpaint.h" 

7 

8 int main(int argc, char **argv) 

9{ 

10 KApplication app(argc, argv, "fontpaint"); 

11 FontPaint fontpaint; 

12 fontpaint.show(); 

13 app. setMain Widget(&fontpaint); 

14 return (app.exec()); 

15} 

16 FontPaint::FontPaint(QWidget ^parent,const char *name) 

17 : QWidget(parent,name) 

18 { 

19 QHBoxLayout *hbox; 

20 QVBoxLayout *vbox = new QVBoxLayout(this,5); 

21 

22 hbox = new QHBoxLayout(5); 

23 topButton = new QPushButton( M Top",this); 

24 hbox->addWidget(topButton); 

25 connect(topButton,SIGNAL(clicked()), 

26 this,SLOT(setTop())); 

27 middleButton = new QPushButton("Middle n ,this); 

28 hbox->addWidget(middleButton); 
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29 connect(middleButton,SIGNAL(clicked()), 

30 this,SLOT(setMiddle())); 

31 bottomButton = new QPushButton( n Bottom M ,this); 

32 hbox->addWidget(bottomButton); 

33 connect(bottomButton,SIGNAL(clicked()), 

34 this,SLOT(setBottom())); 

35 vbox->addLayout(hbox); 

36 

37 frame = new QWidget(this); 

38 frame->setMinimumSize( 150,150); 

39 vbox->addWidget(frame); 

40 

41 hbox = new QHBoxLayout(5); 

42 leftButton = new QPushButton("Left M ,this); 

43 hbox->addWidget(leftButton); 

44 connect(leftButton,SIGNAL(clicked()), 

45 this,SLOT(setLeft())); 

46 centerButton = new QPushButton("Center",this); 

47 hbox->addWidget(centerButton); 

48 connect(centerButton,SIGNAL(clicked()), 

49 this,SLOT(setCenter())); 

50 rightButton = new QPushButton("Right",this); 

51 hbox->addWidget(rightButton); 

52 connect(rightButton,SIGNAL(clicked()), 

53 this,SLOT(setRight())); 

54 vbox->addLayout(hbox); 

55 

56 selectFontButton = new QPushButton( n Select Font",this); 

57 vbox->addWidget(selectFontButton); 

58 connect(selectFontButton,SIGNAL(clicked()), 

59 this,SLOT(popupDialog())); 

60 

61 Hposition = Hcenter; 

62 Vposition = Vmiddle; 

63 font = frame->font(); 
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64 updateDisplay(); 

65} 

66 void FontPaint: : popupDialog() 

67 { 

68 bool okay; 

69 

70 QFont newFont = QFontDialog::getFont(&okay,font,this); 

71 if(okay) { 

72 font = newFont; 

73 updateDisplay(); 

74 } 

75} 

76 void FontPaint: : updateDisplay() 

77 { 

78 int x; 

79 int y; 

80 QString text; 

81 QPainter painter(frame); 

82 painter.setFont(font); 

83 QFontMetrics fin = painter.fontMetrics(); 

84 

85 painter.setBackgroundColo^QColorC'black")); 

86 painter.setPen(QColor( M white M )); 

87 

88 QRect rect = painter. window(); 

89 painter.eraseRect(rect); 

90 

91 switch(Vposition) { 

92 case Vtop: 

93 y = fin.ascent(); 

94 text = "Top 

95 break; 

96 case Vmiddle: 

97 y = rect.height() / 2; 

98 y += (fm.ascent() - fm.descent()) / 2; 



99 text = "Middle 

100 break; 

101 case Vbottom: 

102 y = rect.height() - fm.descent(); 

103 text = "Bottom 

104 break; 

105 } 

106 switch(Hposition) { 

107 case Hleft: 

108 x = 0; 

109 text += "Left"; 

110 break; 

111 case Hcenter: 

112 text += "Center"; 

113 x = (rect.width() - fm.width(text)) / 2; 

114 break; 

115 case Hright: 

116 text+= "Right，，; 

117 x = rect.width() - fin.width(text); 

118 break; 

119 } 

120 painter.drawText(x,y,text); 

121 } 

122 void FontPaint: : paintEvent(QPaintEvent *) 

123 { 

124 updateDisplay(); 

125 } 

16 행에서 시작하는 FontPaint 구성자는 수직칸을 초기배치로 사용하며 19 〜 59 행에서 거 
기에 창문부품들을 채운다 . 3 개 단추를 지정하는 두 행은 각각 수평칸에 놓인다 . 6 개의 위치 
단추는 fontpainth 에서 선언된 처리부메쏘드중 하나와 각각 련결된다 . 37 행에서 만든 frame 창 
문부품은 그림 10-8 에 보여준것처럼 본문을 현시하는데 쓰이는 검은 직 4 각형이다 . 56 〜 59 행 
에서 만들어진 제일 아래 단추는 popupDialog() 라는 처리부메쏘드에 련결된다 . 

66 행 에 서 정 의 된 popupDialog() 처 리 부는 QFontDialog 클라스에 서 정 적 메 쏘드 getFont() 를 
사용하여 새로운 서체를 얻는다 . 새로운 서체가 선택되면 72 행에서 그것이 현재서체로 되며 
updateDisplayO 호출이 이 루어 져 새로운 틀창문을 현시한다 . 
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본문현시는 76 행에서 시작하는 메쏘드 updateDisplay () 에 의해 수행된다 . 본문을 현시하 
기 위하여서는 81 행에서 QPainter 객체를 만들어 야 한다 . QPainter 객체는 한가지 서체를 포함하 
며 그것을 리용하여 그 본문을 모두 그린다 . 82 행에서 선택된 서체는 QPainter 객체에 설정된 
다 . 83 행에서 이 서체에 대한 정보를 포함하는 QFontM 的 'ics 객체는 QPainter 객체로부터 엄어 
진 다 . 

알아두기 : QPainto •클라스는 12 장에 서 설 명 한것 처 럼 많은 기 본도형 조작함수들에 서 사용 
된다 . 이 실례에서 QPainter 구성자는 틀을 목표창문부품으로 사용하지만 그것은 또한 
창문부품에 독립인 QPainter 객체를 만들수 있으며 오직 그리 기를 수행해 야 할 때만 련 
결될수 있다 . 

85 행은 배경색을 흑색으로，전경색을 흰색으로 설정한다 . 이것은 창문부품이 현시될 때 
그것 이 흑색으로 보이고 거기 에 그린 본문은 백색으로 보인다는것을 의미한다 . 

본문의 수직 및 수평위치에 대한 3 가지 선택이 있는데 이것들은 91 행과 106 행에서 
switch 문에 의해 선택된다 . 문자렬을 그리기 위하여서는 기준선의 수직위치와 왼쪽문자의 왼 
끝의 수평위치를 지 정하여 야 한다 . 서체측도정보를 사용하여 문자렬을 배치하는데 필요한 
정확한 위치를 결정할수 있다 . 

93 행에서 y 를 서체의 상승값으로 설정하여 본문을 우에 배치한다 . 즉 기준선의 수직배 
치는 가장 큰 문자의 웃끝이 바로 창문의 웃끝에 닿아야 한다 . 

97 〜 98 행에서 본문이 중심에 나타나도록 수직위치를 설정한다 . 97 행의 식은 창문의 수 
직중심을 결정하지만 상승과 하강이 각이한 값을 가지는것이 거의 확실하므로 본문(기준선 
이 아니다)이 중심에 배치되도록 조절해야 한다 . 98 행은 상승과 하강사이의 차이를 구하여 
중심에 그 차를 추가한다 . 그것을 2 개 명령문으로 나누지 않고 다음과 같이 쓸수 있다 . 
y = ( height + ascent - descent )/2; 

102 행은 이미 그림 10-8 에서 보여준것처럼 최소서체하강이 창문의 아래에 놓이도록 수 
직상태를 계산한다 . 그러기 위하여 창문의 전체 높이에서 하강을 덜어야 한다 . 

108 행은 창문의 왼쪽에서 본문을 시작한다 . 문자렬은 항상 그 x 자리표의 바로 오른쪽에 
그려 지 므로 x 를 0 으로 설정할 필요만 있다 . 

112 행은 본문이 수평으로 중심에 배치되도록 x 자리표를 결정한다 . 창문너비의 절반은 창 
문의 중심이다 . 왼쪽의 위치를 문자렬길이의 절반만큼 조절하면 문자렬이 정확히 중심에 배치 
된다 . width 메쏘드호출은 인수로서 본문을 사용한다 . 이것은 문자렬의 문자수로부터가 아니라 
매개 실제 문자너비의 합계로부터 계산되기때문이다 . Courier 와 같은 고정너비서체들은 간단히 
문자수로부터 너비를 계산할수 있으나 가변너비서체들은 한번에 한 문자씩 계산해야 한다 . 

117 행은 그림 10-8 에서 이미 보여준것처럼 본문의 마지막 문자가 창문의 오른쪽에 맞추 
어 끝나도록 본문의 출발점을 계산한다 . 전체 창문의 너비에서 문자렬너비를 덜어 출발점을 
계산한다 . 일단 본문문자렬을 구성하고 x 와 y 자리표들을 계산한 다음에 120 행의 drawText() 
호출은 창문에 본문을 그리는데 사용된다 . 





122 행의 메쏘드 paintEventO 는 창문이 어떠 한 리유로 로출되 여 다시 그려 야 할 때마다 
호출된다 . 이 메쏘드가 여기서 정의되지 않았다면 창문은 오직 새로운 서체 또는 새로운 위 
치가 선택될 때에만 그러진다 . 

제7절. 직4각형에 의한 서체배치 

이 전의 실례 에서는 QFontMetric 객체를 사용하여 직 4 각형 안에서 여 러 가지 서 체위 치 를 계 
산하였다 . updateDisplay () 메쏘드를 다음 코드로 바꾸면 앞에서 와 꼭같이 현시 된다 . 


76 void FontPaint2 :: updateDisplay() 

77 { 

78 int align; 

79 QString text; 

80 QPainter painter(frame); 

81 painter.setFont(font); 

82 

83 painter.setBackgroundColor(QColor( n black n )); 

84 painter.setPen(QColor("white")); 

85 

86 QRect rect = painter .window(); 

87 painter.eraseRect(rect); 

88 

89 switch(Vposition) { 

90 case Vtop: 

91 align = AlignTop; 

92 text = "Top"; 

93 break; 

94 case Vmiddle: 

95 align = AlignVCenter; 

96 text = "Middle 

97 break; 

98 case Vbottom: 

99 align = AlignBottom; 
text = "Bottom 
break; 


100 

101 

102 
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103 switch(Hposition) { 

104 case Hleft: 

105 align |= AlignLeft; 

106 text += "Left"; 

107 break; 

108 case Hcenter: 

109 align |= AlignHCenter; 

110 text += "Center"; 

111 break; 

112 case Hright: 

113 align |= AlignRight; 

114 text+= "Right"; 

115 break; 

116 } 

117 painter.drawText(rect,align,text); 

118} 


이 실례에서 align 변수는 기발들의 모임으로서 사용된다 . 117 행의 drawTextO 호출은 직 4 
각형안의 본문위 치 를 지 정 하는 기 발들과 함께 전 체 창문의 크기 를 정 의 하는 QRect 객 체 를 사 
용한다 . 모든 기 발들에 대하여서 는 표 10-2 에서 설명한다 . 이 전 실례 에서 사용한것 처 럼 본문 
위치를 지정하는 실제 화소값들은 필요되지 않는다 . 또한 직 4 각형은 전체 창문을 포함할 필 
요가 없고 창문내부에 더 작은 직 4 각형을 지정할수 있다 . 


표 10-2. 직 4 각형안에 넣어진 본문의 위치를 지정하는 기발 


기발이름 

작 용 

AlignBottom 

서체의 최소하강위치의 꼭대기가 직 4 각형의 바닥에 일치하도록 본문위치 
를 지 정 한다 . AlignTop 또는 AlignVCenter 와 함께 사용할수 없 다 . 

AlignHCenter 

본문을 수평 방향으로 중심 에 배 치한다 . AlignLeft 또는 AlignRight 와 함께 

사용할수 없다 . 

AlignLeft 

본문의 제 일 왼쪽 문자는 직 4 각형 의 왼 변과 일치한다 . AlignRight 또는 
AlignHCenter 와 함께 사용할수 없다 . 

AlignRight 

본문의 제 일 오른쪽 문자는 직 4 각형 의 오른변 과 일 치한다 . AlignLeft 또는 
AlignHCenter 와 함께 사용할수 없다 . 

AlignTop 

서체에서 제일 큰 문자의 꼭대기가 직 4 각형의 웃변과 일치하도록 본문위 
치 를 지 정 한다 . AlignBottom 또는 AlignVCenter 과 함께 사용할수 없 다 . 

AlignVCenter 

직 4 각형 의 수직 방향으로 중심 에 본문을 배 치한다 . AlignTop 또는 




기발이름 

작 용 


AlignBottom 과 함께 사용할수 없다. 

DontClip 

만일 직 4 각형이 창문과 본문보다 작으면 문자렬은 직 4 각형에 맞게 잘리 

운다. 이 기발을 리용하면 본문은 직 4 각형에 맞추어 잘리우지 않는다. 

ExpandTabs 

기정으로 매개 타브문자 Y 는 하나의 공백으로 바뀐다. 이 기발을 리용하 

면 다음 문자가 문자렬의 선두로부터 계산하여 8 문자경계에서 표시되도 

록 충분한 공백 을 삽입한다. 

ShowPrefix 

기정으로 본문의 &문자는 그대로 나타난다. 이 기발을 리용하면 &문자 

는 삭제되고 그 오른쪽문자에 밑줄이 그어진다. 실례로 본문 "Mi&ddle 

&Center” 는 이 기 발을 리 용하면 Middle Center^. 나타나며 이 기 발을 리 용 

하지 않으면 Mi&ddle &Center 로서 나타난다. 

SingleLine 

기정으로 새행문자 V 는 본문을 분리하여 한행 이상에 표시되게 한다. 이 

기발을 사용하면 매개 newline 문자는 하나의 공백으로 전환된다. 

WordBreak 

본문이 직 4 각형 에 맞지 않으면 이 기발은 그것이 맞도록 하기 위하여 공 

백위치에 새행문자를 삽입하게 한다. 


본문은 여러행으로 분리될수 있으며 그 결과로 생기는 블로크는 alignment 기발들에 
라서 적합한 위치에 배치된다. 앞의 실례에서 본문의 두 단어는 하나의 공백으로 식별 5 
으므로 한행에 나타났다. 그림 10-9 에서는 이전 실례의 코드를 다음과 같이 바꿈으로써 
어들사이에 새행문자 ’\ n ’ 틀 사용하였을 때 발생하는 배치를 보여준다. 


89 switch(Vposition) { 

90 case Vtop: 

91 align = AlignTop; 

92 text = M Top\n M ; 

93 break; 

94 case Vmiddle: 

95 align = AlignVCenter; 

96 text = ’’Middled”: 





그림 10-9. 창문에 여 러행 본문의 배 치 

요 약 

도형방식사용자대면부에 현시되는 모든 요소들중에서 기본은 문자, 수, 그리고 구두점 
찍 기 이 다. 

몇개의 문자서체들은 매우 매 력있어 보이며 반면에 다른 문자서체들은 나쁘게 보인다. 
우리가 좋아하는 서체와 좋아하지 않는 서체사이의 실제차이는 매우 작다. 문자들이 보통 
매우 작은 도형객체로 창문에 현시되 여도 우리는 그 상세한 모양을 곧 인식할수 있다. 문자 
모양의 이러한 예상된 표기는 서체가 우리에게 아주 훌륭하게 보일수 있기때문이다. 

이 장에서는 서체조작의 기초를 설명하였다. 즉 

• 매개 서체는 그 자체의 파일에 보관되므로 새로운 서체들을 추가하거나 이전 서체 
를 쉽게 삭제할수 있다. 

• 자기 응용프로그람은 정 확한 이 름으로 특정한 서 체를 서 술할수 있다. 또는 서 체계 렬 
과 점크기와 갈은 서술적인 용어를 사용함으로써 서체를 선택할수 있다. 

•창문에서 표준값모임을 리용하여 본문위치를 지정하고 현시하는 본문의 크기를 결정 
할수 있다. 

• 사용자가 서체를 선택할수 있게 하기 위하여 QFontDialog 또는 KFontDialog 창문부 
품을 프로그람에 포함할수 있다. 

이 장에서는 창문부품의 창문에 본문을 그리는 방법을 론의하였다. 






제 11 장. 색 


학습내용 

체계가 색을 만드는 방법 

단일색을 포함하는 객체의 만들기 

사용자에게 색선택을 의뢰 

색들을 련관된 그룹으로 묶기 

색그룹들을 조색판으로 묶기 

한개 창문부품，여러 창문부품 혹은 모든 창문부품용으로 조색판을 지정하는 방 
법 

이 장에서는 응용프로그람의 대면부를 만드는 여러가지 창문부품들의 색을 설정하는 
방법을 설명한다 . 모든 창문부품들에서 사용하는 모든 색을 표준화하기 위한 채색기술을 사 
용하거나 개별적인 창문부품에 유일한 색을 지정할수 있으며 또는 이 두가지 수법을 결합하 
여 사용할수 있다 . KDE 와 어는 사용자의 요구에 따라 창문부품색을 설정 및 재설정할수 있 
다 . 

모든 XII 색은 그 기본적인 원색부분들로 분리할수 있는 하나의 수값으로서 정의된다 . 
QCol 이•객체는 하나의 XII 색을 보관하는 용기이다 . QColorGroup 객체는 창문부품창문의 여 
러가지 부분을 착색하는데 사용된 한조의 QColor 객체를 가진다 . QPalette 객체는 3 조의 
QColorGroup 를 포함하는데 그것은 창문부품의 매개 상태에 대한 색을 지정하는데 사용된 
다 . 이것들은 응용프로그람의 조종하에 있다 . 

가장 낮은 준위에서 색은 현시된 화소에 적용된 수값이다 . 기본원칙은 같지만 도형기판 
에 따라서 약간 다른 수법들을 리용한다 . 이 장은 주로 그 수법들을 설명한다 . 일부 도형기 
판은 자기의 체계 에서 색을 현시할수 있는 수법들을 자체로 인식하지만 기판은 사용자들이 
구동프로그람을 적재하여야 한다 . 


제1절. 색의 구조 

X 창문체계의 색체계는 2 진값으로 표시된 3 가지 원색을 사용한다 . 매개 색의 세기는 가 
능한 최대값에 대한 색값의 비률이다 . 실례로 색당 8Wt 를 가지는 체계에서 50% 적색을 얻 
으려고 할 때 값은 127 이다 . 색당 16bit 를 가지는 체계에서 50% 적색을 얻으러고 할 때에 
값은 32,767 이다 . 또한 색은 대체로 0.0 〜 1.0 범위의 류동소수점값으로 표시될수 있으므로 
50% 색준위는 0.5 이다 . 

현시구조의 종류는 아주 많다 . XII 은 표준방법으로 그것들을 다투는 방법을 제안하였 
다 . KDE 八 3t 쏘프트웨 어 는 이 와 같이 일 반화된 체 계 우에 구축되 므로 저 준위 의 세 부를 모두 알 
필요는 없다 . 그러나 프로그람이 말아 수행하여야 할 일부 조작들을 리해하려면 일정한 기 
초가 있어야 한다 . 




물리적인 현시장치는 거기에 배치하는 매개 화소에 대한 위치를 기억하고 하드웨어기 
억기를 가지고있다. 기억기의 매개 값은 그와 련결된 화소의 색과 밝기를 결정하며 화소를 
변경하려면 그 기억장소의 내용을 변경하여야 한다. 하드웨어는 기억된 값을 색으로 변환할 
때 다른 방법을 사용한다. 즉 기억기의 일부 수값은 직접 색값으로 바꾸며 나머지 수값은 
색표에 대한 색인으로 사용한다. 색표는 색략도로 알려져있다. 하드웨어에 따라 각이한 종류 
의 색략도를 요구한다. 표 11-1 은 여러가지 형들을 보여준다. 


표 11-1. 

물리현시장치의 부류 

이름 

설명 

가상색 

(Pseudo 

Color ) 

화소값은 RGB 값들을 포함하는 색략도를 색인한다. 색략도는 동적으로 

변경될수 있다. 

직접색 

separate 화소값은 3개 값으로 구분되고 3개의 독립적인 색략도를 색 

인하는데 쓰인다. 즉 적색요소에 하나，청색요소에 하나, 록색요소에 

하나. 색략도들은 동적으로 변경될수 있다. 

회색 비례 
(Gray Scale ) 

화소값은 현시가능한 회색비려 Kscale ) 값을 포함하고있는 색략도를 색 

인한다. 색략도는 동적으로 변경할수 있다. 

정적색 

화소값은 RGB 값을 포함하는 색략도를 색인한다. 색략도는 하드웨어에 

서 정적이고 변경될수 없다. 

참색 

(True Color ) 

화소값은 3개의 값으로 분리되고 3개의 독립적인 색략도를 색인하는 

데 쓰인다. 즉 적색요소에 하나，푸른색요소에 하나，그리고 록색요소 

에 하나. 매개 색략도는 무색으로부터 완전포화까지 균일한(또는 근사 

균일한) 경사도이며 변경할수 없다. 

정적회색 

화소값은 현시 가능회 색 비 례 값들을 포함하는 색 략도를 색 인 한다. 색 략 

도는 정적이고 변경될수 없다. 


색략도는 모든 창문의 모든 화소들을 그리기 위하여 현시기하드웨어에 의해 사용되므 
로 색략도의 변경은 모든 모양을 변경한다. 일부 색략도는 이려한 변경을 허용하며 일부는 
허용하지 않는다. 드물게 색략도를 변경할 필요가 있지만 응용프로그람이 색략도를 변경하 
면 다른 응용프로그람으로 옮겨 변경하고 다시 응용프로그람으로 되돌아와야 한다. 

다음 프로그람은 자기가 어떤 종류의 현시기를 가지고있으며 화소당 비트수, 색략도의 
크기 그리고 일부 다른 관련정보를 현시한다. 

1 /* showvisual.cpp */ 

2 #include <kapplication.h> 

3 #include <qlabel.h> 

4 #include <qlayout.h> 
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5#include<Xll/Xlib.h> 
6 #include "showvisu 公 l.h" 


8 int main(int argc, char **argv) 

9{ 

10 KApplication app(argc, argv, "showvisual"); 

11 ShowVisual showvisual; 

12 showvisual.show(); 

13 app.setMainWidget(&showvisual); 

14 retum(app. exec()); 

15} 

16 ShowVisual: :ShowVisual(QWidget *parent,const char *name) 

17 : QWidget(parent,name) 

18 { 

19 QString str; 

20 QLabel *label; 

21 

22 QVBoxLayout *vbox = new QVBoxLayout(this, 10); 

23 

24 str.sprintf("%4d Screen number",xl 1 Screen。); 

25 label = new QLabel(str,this); 

26 vbox->addWidget(label); 

27 

28 str.sprintf("%4d Bits per pixel",xl lDepth()); 

29 label = new QLabel(str,this); 

30 vbox->addWidget(label); 

31 

32 str.sprintf("%4d X dots per inch'xl lAppDpiXQ); 

33 label = new QLabel(str,this); 

34 vbox->addWidget(label); 

35 

36 str.sprintf("%4d Y dots per inch",xl lAppDpiY()); 

37 label = new QLabel(str,this); 

38 vbox->addWidget(label); 

39 
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40 Visual *visual = (Visual *)x1 lVisual(); 

41 

42 str.sprintf(，，%4d Bits per RGB，，, 

43 visual->bits_per_rgb); 

44 label = new QLabel(str,this); 

45 vbox->addWidget(label); 

46 

47 str.sprintf("%4d Colormap entries", 

48 visual->map_entries); 

49 label = new QLabel(str,this); 

50 vbox->addWidget(label); 

51 

52 switch(visual->c_class) { 

53 case StaticGray: 

54 str.sprintf("%4d StaticGray class", 

55 visual->c_class); 

56 break; 

57 case Grayscale: 

58 str.sprintf("%4d Grayscale class", 

59 visual->c_class); 

60 break; 

61 case StaticColor: 

62 str.sprintf( M %4d StaticColor class’’, 

63 visual->c_class); 

64 break; 

65 case PseudoColor: 

66 str.sprintf( M %4d PseudoColor class”, 

67 visual->c_class); 

68 break; 

69 case TrueColor: 

70 str.sprintf("%4d TrueColor class", 

71 visual->c_class); 

72 break; 

73 case DirectColor: 

str.sprintf("%4d DirectColor class", 


74 
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7 5 visual->c_class); 

76 break; 

77 } 

78 label = new QLabel(str,this); 

79 vbox->addWidget(label); 

80 

81 str.sprintf( M 0x%08X Red Mask", 

82 visual->red_mask); 

83 label = new QLabel(str,this); 

84 vbox->addWidget(label); 

85 

86 str.sprintf("0x%08X Green Mask”, 

87 visual->green_mask); 

88 label = new QLabel(str,this); 

89 vbox->addWidget(label); 

90 

91 str.sprintf( M 0x%08X Blue Mask", 

92 visual->blue_mask); 

93 label = new QLabel(str,this); 

94 vbox->addWidget(label); 

95 

96 resize(10,10); 

97} 

이 프로그람에 의해 현시된 모든 정보는 실제로 저준위 XII 체계에 의해 제공된다 . 
QWidget 객체는 QPaintDevice 기초클라스로부터 모든 메쏘드들을 계승하므로 같은 정보를 
어떠 한 창문부품으로부터 검 색 할수 있다 . 그림 11-1 은 동시 에 256 색을 현시할수 있는 체계가 
생성한 정보를 현시한 색특성을 보여준다 . 
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0 Screen number 
24 Bits per pixel 
96 X dots per inch 
96 Y dots per Inch 
8 Bits per RGB 
256 Colormap entries 


4 TmeColo 
JxOOTTOOOO 
JxOOOOFFOO 
JxOOOOOOFF 


lor class 
Red Mask 
Green Mask 
Blue Mask 


그림 11-1. 현시의 색특성 

24 〜 26 행은 화면번호를 현시하는 표식자를 만든다 . 이 번호는 항상 0 이지만 XII 이 많 
은 화면을 동시에 조종하도록 설계되므로 매 화면이 서로 다른 번호를 가질수 있다 . 또한 
XII 은 망용으로 설계되 였으므로 어 떤 화면들은 다른 콤퓨터표시 장치 에 현시할수 있다 . 즉 
같은 응용프로그람이 여러 콤퓨터들에 화면을 동시 에 현시하게 할수 있다 . 

28 〜 30 행은 매개 화소에 할당된 하드웨 어비 트수를 현시 하는 표식자를 만든다 . 갈은 값 
을 가지는 2 개 화소는 갈은 색을 정확히 가지므로 총동시색수는 256 으로 제한된다 . 

32 〜 38 행은 수평과 수직 두 방향에서 인치당 점의 개수를 지정하는 한쌍의 표식자를 
만든다 . terminal 의 환경 구성 에 대 하여 쏘프트웨 어 가 아는 방법 이 없으므로 이 값은 오직 근 
사값이다 . CRT 는 조절할수 있는 너비와 높이를 가지고 있으며 현시구역에서 모든 변들에서 
직선으로 되는것은 아니다 . 

40 행의 xllVisualO 호출로 Visual 구조체를 얻으며 이 구조체는 현시기에 대한 기본정보 
를 가진 저 준위 XII 구조체 이다 . 이 값들은 현시 된 창문의 나머 지 부분을 만드는데 사용된다 . 
이 구조체 는 X 쏘프트웨어 의 부분이 므로 5 행 에 서 수행 된것 처 럼 파일 Xlib 上를 포함하여 야 한 
다 . 


42 〜 45 행은 RGB 값당 6bit 가 있다는것을 알리는 표식자를 만든다 . 즉 18bit (매개 원색에 
6 ) 는 완전 색 값을 표시한다 . 색 의 투명 도를 지 정 하는 다른 的 it 값 ( 알파값)이 흔히 있으므로 
RGB 당 6 화소는 자주 24bit 색체계로서 언급된다 . 

매개 6bit 옹근수들이 0 〜 63 의 값을 포함할수 있고 64 의 3 제급이 262144 이므로 그것은 
이 체계가 보관할수 있는 색의 총수이다 . 그러나 그것은 동시에 256 색을 현시할수 있다 . 47 
~50 행은 색략도안의 총항목수를 보여주는 표식자를 만든다 . 수 256 은 화소당 8 bit 이므로 당 
연한 값이 다 . 색 략도배렬의 매개 성원은 24bit 이므로 각자는 색의 4 개 값 ( 적색，록색，청색 그 
리고 알파:)을 가질수 있다 . 






52 〜 76 행은 현시 기 의 부류를 지 정 하는 표식 자를 만든다. 형이 름은 5행 에서 포함되 는 X 
머리부파일들에서 선언된다. 이 실례에서 8 bit 화소에 보관한 값이 색략도배렬의 색인으로 사 
용된다는것을 의미하는 가상색을 현시기가 리용한다. 그리고 색략도의 값들은 응용프로그람 
이 조절할수 있다. 

81〜94행은 3가지 색마스크의 값들을 현시하는 표식자들을 만든다. 그것들은 오직 참색 
과 직접색에만 적용하므로 이 실례에서 0이다. 이 현시기부류들은 둘다 매개 원색에 대하여 
독립적인 색략도를 사용하며 마스크들은 화소값들로부터 매개 배렬에로 색인값들을 얻어내 
는데 사용된다. 사실상 매개 색략도가 오직 한가지 색을 포함하고 심지어 무색(흑색；)으로부 
터 완전한 색밝기까지 그림자처리가 있으므로 흔히 실제색략도는 없다. 대신에 마스크의 크 
기는 색마다 다를수 있으며 색이 이 두 한계값들사이의 어느 값을 가지는가를 결정하는데 
사용된다. 

XII 체계로부터 창문과 화면에 대한 정보가 더 있으나 아마도 그것들을 구체적으로 알 
필요는 없다. XII 루린들을 피 하는것의 우점 들중 하나는 자기의 코드가 더 간단해지 는것 이 다. 
게 다가 자기 가 작성한 응용프로그람은 한 체계 에서 다른 체계 에로 이 식 할수 있다. 

제2절. QC 이 or 객체의 구성 

QColor 객체는 색의 정의를 포함한다. QColor 객체를 만드는 방법은 많다. 다음 프로그람 
은 그림 11-2 에 보여준 도색된 표식자모임을 창조함으로써 QColor 객체를 만드는 서로 다른 
방법 을 보여 주는데 매 번 QColor 구성 자인수의 각이한 모임 을 사용한다. 

1 /* colormaker.cpp */ 

2 #include < kapplication . h > 

3 #include < qlabel . h > 

4 #include < qlayout . h > 

5 #include ’’ colormaker . h ” 

6 

7 int main(int argc , char ** argv ) 

8 { 

9 KApplication app ( argc , argv , " colormaker "); 

10 ColorMaker colormaker ; 

11 colormaker . show (); 

12 app . setMainWidget (& colormaker ); 

13 retum ( app . exec ()); 

14} 

15 ColorMaker : : ColorMaker(QWidget ^ parent,const char * name ) 

16 : QWidget ( parent , name ) 




17 { 

18 QString str; 

19 QLabel *label; 

20 

21 QVBoxLayout *vbox = new QVBoxLayout(this ， 3); 

22 

23 label = new QLabel("Defined by RGB numbers",this); 

24 label->setBackgroundColor(QColor(250,150,100)); 

25 vbox->addWidget(label); 

26 

27 label = new QLabel("Defined by RGB numbers",this); 

28 label->setBackgroundColor(QColor( 150,250,100, 

29 QColor::Rgb)); 

30 vbox->addWidget(label); 

31 

32 label = new QLabel(’’Defined by HSV numbers", this); 

33 label->setBackgroundColor(QColor(310,150,250, 

34 QColor::Hsv)); 

35 vbox->addWidget(label); 

36 

37 label = new QLabel("Defined by QRgb value", this); 

38 QRgb rgb = OxOOFOEOOO; 

39 label->setBackgroundColor(QColor(rgb)); 

40 vbox->addWidget(label); 

41 

42 label = new QLabel("Defined by colormap index",this); 

43 label->setBackgroundColor(QColor(rgb,86)); 

44 vbox->addWidget(label); 

45 

46 label = new QLabel("Defined by RGB name",this); 

47 label->setBackgroundColor(QColor( M #F58F95 M )); 

48 vbox->addWidget(label); 

49 

50 label = new QLabel("Defined by file name",this); 

51 label->setBackgroundColor(QColor( M green")); 
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52 vbox->addWidget(label); 

53 

54 resize(10 ， 10); 

55} 



Defined by RGB numbers 

Defined by RGB numbers 

Defined by HSV numbers 
Defined by QRgb value 


Defined by RGB name 
Defined by file name 

그림 11-2. 색을 만드는 몇가지 기본방법 

매개 창문부품은 배경 색을 가지고있다 . 이 실례는 QLabel 창문부품집 합의 배경 색을 
QColor 객체를 사용하여 설정한다 . 배경색은 창문부품의 배경을 색칠하는데 사용된다 . QLabel 
에서 배경색으로 전체 창문부품을 채색한 다음 본문을 그 우에 쓴다 . QColor 객체를 만들 때 
마다 구성자가 현재 색략도에 새로운 색의 삽입이 필요할수 있다 . 색이 색략도에 이미 있다 
면 어떤 작용도 필요하지 않다 . 그러나 색을 추가해야 하는데 색략도에 빈자리가 없으면 
QColor 객체는 색략도에서 가장 가까운 위치에 있는 색에 간단히 련결한다 . 이것때문에 많은 
색을 가지는 응용프로그람은 상황에 따라 좀 다르게 보일수 있다 . 

23 〜 25 행은 RGB 값으로 지정된 색을 가지는 표식자를 만든다 . 매개 값은 1 〜 255 범위에 
있으며 여기서 0 은 색 이 없고 255 는 최대 량을 자진다 . RGB 값 0,0,0 은 흑색 이고 255,255,255 
값은 백색이다 . 

27 〜 30 행은 3 개 값이 RGB 값으로 해석된다는것을 구성자에 알리는 추가적인 인수를 내 
놓으면 이전 실례에서와 같이 R GB 값을 사용하여 색을 만든다 . 

32 〜 35 행은 28 행에서와 같이 QColor 구성자를 사용하지만 RGB 대신에 HSV ( 색 , 농도 , 값 ) 
를 사용하여 QColor 객체를 만든다 . RGB 색에서처럼 HSV 색도 3 개 인수에 의해서 정의되지만 수 
값들은 아주 다른 의미를 가지고있다 . 또한 HSB ( 색 , 농도 , 밝기)가 HSV 와 련관된다는것을 알 
수 있다 . H 값은 색 (hue, tint ) 으로서 색스펙트로에서 빛의 빈도수를 지정한다 . S 값은 농도 
(saturation, shade ) 로서 기준색이 더 밝아지거나 어두워지도록 혼합하는 흑색이나 백색의 량을 
지 정 한다 .B 또는 V 값 ( 밝기 brightness 또는 빛세기 luminosity ) 는 색 이 현시 되는 농도를 지 정 한다 . 

HSV 색을 만들 때 구성자에 넘긴 H 값은 색을 선택하기 위하여 0 〜 360 범위 에 있거나 또 
는 4 로서 색 ( 회색 , 흑색 또는 백색)이 없다는것을 지정할수 있다 . S 값은 0 ( 최대로 흑색이 포 
함 ) 〜 255 ( 최대로 백색이 포함)에서 변한다 . 순수색을 얻기 위하여 농도로서 127 을 사용한다 . 
V 또는 B 값은 0( 최소밝기 ) 〜 255( 최대밝기)에서 변한다 . 

37 〜 40 행은 RGB 값으로 색을 지정하지만 3 개 값은 모두 한개 옹근수에 보관된다 . 편리 






상 값 그자체는 38행에서 16진값으로 선언된다. 값의 첫째 바이트는 무시되고 적색값은 
OxFO, 록색은 OxEO 그리고 청색은 0x00 이다. 

42〜44행은 색 략도에 대 한 색 인을 사용함으로써 색 을 지 정한다. 구성 자의 둘째 인수(수 
값 86 ) 는 색략도에 대한 색인이고 첫째 인수는 RGB 값에 포함되는 옹근수이다. 색인값은 부 
호없는 수이지만 OxFFFFFFFF 로서 그것을 지정하려고 하였다면 색인은 무시되고 RGB 값이 
대신에 사용된다. 

46〜48행은 색을 지정하기 위하여 RGB 값의 16진문자형식을 사용한다. 실례에 사용한 
수값문자렬형식은 "#RRGGBB" 이지만 그것은 ”#RGB”, "#RRRGGGBBB" 또는 
’’#RRRRGGGGBBBB" 일수도 있다. 색정의쏘프트웨어는 선두의 #문자를 탐지하고 값들을 꺼 
내기전에 나머지 문자렬을 갈은 부분들로 나눈다. 

50〜52행은 파일 /usr/lib/Xl 1/rgb.txt 의 항목으로부터 만들어진 QColor 객체를 사용한다. 
이것은 평문파일이고 매개 항목은 색에 대한 이름과 RGB 값을 포함한다. 실례로 
60 179 113 MediumSeaGreen 
32 178 170 LightSeaGreen 
152 251 152 PaleGreen 
0 255 0 green 

0 250 154 MediumSpringGreen 

이 파일에 750 개 항목이 있고 파일은 XII과 함께 배포되므로 거기에 있는 이름들을 사 
용하는것이 안전하다고 느낄수 있다. 거의 모든 색이 하나이상의 이름을 가지고 있으므로 
파일에 750이하의 유일한 색이 있다. 또한 원한다면 자기의 이름을 추가하고 자기의 프로그 
탐이 그것 들을 리 용할수 있으나 자기 응용프로그람을 이 식할수 없다. 

제3절. KColorDialog 

응용프로그람에 색을 설정하는 수법은 여러가지 있다. 간단히 색을 무시하고 기정값들 
을 사용할수 있으며 매개 창문부품에 특정한 색값을 설정하거나 사용자가 색을 선택하게 할 
수 있다. KColorDialog 는 사용자가 색을 선택 할수 있는 튀 여나오기 대화칸이 다. 다음 실례는 
KColorDialog 를 펼치고 사용자가 선택한 색정보를 엄는 방법을 보여준다. 

그림 11-3 에 보여주는 응용프로그람의 기본창문은 색현시대화칸을 펼치는 단추를 아래 
에 포함한다. 창문의 꼭대기에 현재 선택된 색의 16진 RGB (적, 록，청)값이 있다. 창문의 중 
심에 색을 현시하는 블로크가 있다. 
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그림 11-3. 색현시대화칸 

ShowColor 머 리 부파 일 

1 /* showcolor.h */ 

2 #ifndef SHOWCOLOR_H 

3 #define SHOWCOLOR_H 

4 

5 #include < qwidget . h > 

6 #include < qlabel . h > 

7 #include < qstring . h > 

8 

9 class ShowColor : public QWidget 

10 { 

11 Q_OBJECT 

12 public : 

13 ShowColor(QWidget * parent =0 ,const char * name =0); 

14 private : 

15 QLabel * label ; 

16 QWidget * widget ; 

17 QColor color ; 

18 QString colorName ; 

19 private slots : 

20 void popup (); 

21}； 

22 

23 #endif 

ShowColor 클라스는 그림 11-3 에 기본창문을 현시하는 창문부품이다. 그것은 RGB 값을 
표시하는 표식자와 중간에 색을 현시하는 창문부품을 포함한다. 또한 QColor 객체에 현재색 
을 보관하고 색 이 름을 QString 객 체 에 보관한다. 색 이 름은 RGB 값의 16진표시 이 다. 처 리 부메 
쏘드 popup () 은 단추를 찰칵할 때마다 KColorDialog 를 현시하는데 사용된다. 







ShowColor 


1 /* showcolor.cpp */ 

2 #include <kapplication.h> 

3 #include <qpushbutton.h> 

4 #include <qlayout.h> 

5 #include <kcmdlineargs .h> 

6 #include <kcolordlg.h> 

7 #include ’’showcolor 上 " 

8 

9 int main(int argc, char **argv) 

10 { 

11 KCmdLineArgs::init(argc, argv, ’’showcolor", 

12 "Show Color", M 0.0 M ); 

13 KApplication app; 

14 ShowColor showcolor; 

15 showcolor. show(); 

16 app.setMainWidget(&showcolor); 

17 return (app.exec()); 

18} 

19 ShowColor: :ShowColor(QWidget *parent,const char *name) 

20 : QWidget(parent,name) 

21 { 

22 QVBoxLayout *box = new QVBoxLayout(this,0,3 )； 

23 

24 colorName = M #FF0000 M ; 

25 color. setNamedColor(colorName); 

26 label = new QLabel(colorName,this); 

27 label->setFont(QFont("Courier M , 16)); 

28 label->setAlignment(Qt: : AlignHCenter); 

29 box->addWidget(label); 

30 

31 widget = new QWidget(this); 

32 widget->setFixedHeight(40); 

3 3 widget->setBackgroundColor(color); 

34 box->addWidget(widget); 
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35 

36 QPushButton ^button = new QPushButton("Select Color", 

37 this); 

38 box->addWidget(button); 

39 connect(button,SIGNAL(clicked()), 

40 this,SLOT(popup())); 

41 

42 resize(10,10); 

43 box->activate(); 

44} 

45 void ShowColor :: popup() 

46 { 

47 int cond = KColorDialog :: getColor(color,this); 

48 if(cond = KColorDialog: : Accepted) { 

49 colorName = color.name(); 

50 label->setT ext(colorName); 

51 widget->setBackgroundColor(color); 

52 } 

53} 

편리상 이 원천파일은 mainO 함수와 ShowColor 클라스의 실행가능코드를 모두 포함한다 . 
9 행 에 서 시 작하는 main () 함수는 간단히 최 상위창문을 만들고 그안에 ShowColor 창문부품을 
삽입 한다 . 

19 행에서 시작하는 ShowColor 구성자는 수직 칸을 만들고 거기에 3 개 창문부품을 삽입 한 
다 . 24 〜 25 행 은 초기 색 을 적 색 으로 설 정한다 . 이 름을 현 시 하는 표식 자는 26 행 에 서 만들어 진 
다 . 27 행은 setFontO 를 호출하여 고정서체로 16 진수들을 현시한다 . setAlignmentO 호출은 중심 
에 본문을 배치하고 29 행의 addWidget () 호출은 칸에 표식자를 삽입한다 . 

창문의 중심에 현시된 색블로크는 간단히 배경색만 설정된 창문부품이다 . 그것은 31 행 
에서 창조되며 그 높이는 28 행 에서 40 화소로 고정된다 . 수직칸이 그 너 비를 조종하므로 그 
것을 설정 할 필요는 없다 . 33 행 에서 setBackgroundColorO 가 호출되 여 다른 방법 으로 빈 창문 
부품을 칠한다 . 

36 〜 40 행은 단추를 만들어 칸에 삽입하고 popup 。 에 련결한다 . 

45 행에서 시작하는 popup () 은 단추를 누를 때마다 실행된다 . 그것은 그림 11-4 에 보여주 
는 KColorDialog 창문을 현시 하는 정 적메쏘드 getColorO 호출에 의해 시 작된다 . 이 메쏘드는 사 
용자가 색을 선택하거나 선택하지 않은채 대화칸을 닫을 때까지 돌아오지 않는다 . 색이 선 
택되였으면 cond 의 값은 색이 선택되였다는것을 가리키는 상수값 KColorDialog::Accepted 과 
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같아진다. 색이 선택되면 그것은 getColorO 에 넘긴 첫째 인수로서 QColor 객체에 놓인다. 49행 
에서 새로운 색의 이름을 얻고 50행에서 이름이 표식자에 삽입된다. 51행은 
setBackgroundColorO 를 호출하여 창문부품에 의해 중심에 현시되는 색을 갱신한다. 



그림 ll -4. KColorDialog 창문 

47행의 getColorO 호출은 첫째 인수로서 QColor 객체를 사용한다. 넘긴 색은 기정색값이 
고 그것은 KColorDialog 창문의 현시를 초기화한다. 이 실례는 늘 현시되는 색을 넘기므로 대 
화칸의 기정색은 현재색이다. KColorDialog 창문부품은 여러가지 방법으로 색을 선택하는데 
사용된다. 왼쪽웃구석의 그룹은 체계색의 집합을 제시하는데 체계색은 KDE 체계의 부분으로 
정의되 여 대부분의 구성 요소들에서 사용된다. 이 색들은 각이한 콤퓨터들에서 대체로 동일 
하다. 또한 색은 오른쪽웃구석의 2개 색선택칸에서 마우스를 사용하여 선택할수 있다. 큰 칸 
의 둘레에 +지시자를 끌고갈 때 오른쪽 아래에서 RGB 와 HSV 값들이 변화하는것을 보게 된 
다. 색을 선택하는 세번째 방법은 왼쪽 아래에서 집합에 보관한 사용자정의색들중 하나를 
선택 하는것이다. 

알아두기: 매개 사용자가 사용하는 사용자정의색은 파일 ~/ kde / share / config / kdeglobals 에 
보관되 며 KColorDialog 가 펼쳐 질 때마다 얻어 진다. 

사용자정의색을 추가하려 면 우선 사용자정 의색들의 집 합에서 한개 칸을 선택 한다. 다음 
에 왼쪽의 체계색으로부터 또는 오른쪽의 색판으로부터 마우스로 색을 선택한다. 일단 선택 
한 다음에 는 Add to Custom Colors 표식 자가 있는 단추를 눌러 서 그것 을 삽입 한다. 




















제 4 절. QColorGroup 안의 QColor 들 


몇가지 색들은 창문부품을 그릴 때 포함할수 있다. 실례로 누름단추는 배경색, 웃그 * 
자색，바닥그림자색 그리고 본문색을 가지고있다. 단추가 이 모든 색을 그리는데 사용할ᅀ 
있는 QColor 객 체 가 있 어 야 한다. 창문부품에 따라 색 모임 에 대 한 각이한 요구가 있다. 요 : 
조건들은 단추를 누르거나 마우스위치가 변할 때 그리고 창문부품우를 지날 때와 같이 짧ᄀ 
순간에 변할 때이다. 

QColorGroup 클라스는 창문부품이 하나의 단위에 요구하는 모든 색을 밀봉하도록 설고 
된다. 각종 창문부품들과 그것들이 가질수 있는 각이한 폼과 함께 QColorGroup 은 광범한 ^ 
항목을 포함하여야 한다. 표 11-2 에서는 매개 QColorGroup 에 포함되는 14가지 색을 보여 1 


다. 

표 11-2. 

QColorGroup 객체에 포함된 색들 

이름 

설명 

Background 

이 색은 거의 모두 창문부품들의 배경에서 사용된다. 

Base 

이 것은 Background 로 정 의한것보다 밝은 색으로 하려 는 창문부품들의 배 
경색이다. 이것은 흔히 백색이면서 보다 연한 색이다. 

BrightText 

이 색은 Dark 가 배경으로 사용될 때 본문을 표시하는데 쓰일수 있다. 

Button 

이것은 단추의 배경색이다. 창문부품의 나머지 부분을 이 색으로 도색한다. 

ButtonText 

이 색은 Button 이 배경으로 사용될 때 본문을 표시하는데 쓰인다. 

Dark 

이 색은 Button 색보다 어둡고 단추에 3차원모양을 주기 위한 그림자처 리 
에 Light 와 함께 사용된다. 

Foreground 

이 색은 창문부품의 표면에 문자들을 쓰거나 그리는데 사용된다. 

Highlight 

이것은 강조되거나 선택된 항목을 칠하는데 사용되는 배경색이다. 

HighlightedText 

이것은 배경색으로서 Highlight 와 대조되는 색으로서 본문을 현시하는데 

적합하다. 

Light 

이 색 은 Button 색 보다 밝고 창문부품에 3차원모양을 주기 위한 그림 자처 

리에 Dark 과 함께 사용된다. 

Mid 

이 색은 복잡한 그림자처리를 요구하는 창문부품들에서 Button 과 Dark 사 

이의 값이다. 

Midlight 

이 색은 복잡한 그림자처 리를 요구하는 창문부품들에서 Button 과 Light 사 

이의 값이다. 

Shadow 

이 색은 매우 어둡고 뚜렷한 그림자처리에 사용된다. 그것은 흔히 흑색이다. 

Text 

이 것은 창문부품의 표면 에 평 본문을 그리 는데 사용되 는 색 이 다. 그것은 
Foreground 와 같다. 


다음 프로그람은 창문부품의 현재 QColorGroup 을 엄고 거기에 포함된 색들을 모두 현， 




하기 위한 프로그람이다. 이 응용프로그람은 그룹의 색들을 변경할수 없으므로 기정색과 값 
들을 현시한다. 그림 11-5 에 보여주는것처럼 프로그람은 14가지 색，색이름 그리고 매개의 
16진표시 를 모두 현시한다. 

1 /* showgroup.cpp */ 

2 #include < kapplication . h > 

3 #include < qlabel . h > 

4 #include < qpalette . h > 

5 #include " showgroup . h " 

6 

7 struct namelistStruct { 

8 QString name ; 

9 QColorGroup : :ColorRole value ; 

10 } namelist [] = { 

11 {" Background ", QColorGroup: : Background }， 

12 {’’ Base ’’， QColorGroup :: Base }, 

13 {" BrightText ", QColorGroup :: BrightText }, 

14 {" Button ", QColorGroup :: Button }, 

15 {" ButtonText ", QColorGroup :: ButtonText }, 

16 {" Dark ”, QColorGroup::Dark }, 

17 {" Foreground ", QColorGroup::Foreground }, 

18 {" Highlight ", QColorGroup :: Highlight }, 

19 {" HighlightedText ", QColorGroup::HighlightedText }, 

20 { " Light ”, QColorGroup::Light }, 

21 {" Mid ", QColorGroup: : Mid }, 

22 {" Midlight ", QColorGroup :: Midlight }, 

23 {" Shadow ", QColorGroup :: Shadow }, 

24 {" Text ", QColorGroup :: Text } 

25}; 

26 

27 int main(int argc , char ** argv ) 

28 { 

29 KApplication app ( argc , argv , " showgroup "); 

30 ShowGroup showgroup ; 

31 showgroup . show (); 

3 2 app . setMainW idget (& showgroup ); 

33 return ( app . exec ()); 

34} 
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35 ShowGroup :: ShowGroup(QWidget *parent,const char *name) 

36 : QWidget(parent,name) 

37 { 

38 QHBoxLayout *hbox; 

39 QVBoxLayout *vbox = new QVBoxLayout(this,0,3 )； 

40 int size = sizeof(namelist)/sizeof(namelistStruct); 

41 for(int i=0; i<size; i++) { 

42 hbox = newColorLine(i); 

43 vbox->addLayout(hbox); 

44 } 

45 resize(10,10); 

46} 

47 QHBoxLayout * ShowGroup :: newColorLine(int i) 

48 { 

49 QLabel *label; 

50 QHBoxLayout *hbox = new QHBoxLayout(); 

51 QColorGroup group = colorGroup(); 

52 QColor color = group.color(namelist[i] .value); 

53 

54 label = new QLabel("’’,this); 

55 label->setBackgroundColor(color); 

56 label->setMinimumWidth( 100); 

57 hbox- 〉 addWidget(label); 

58 

59 label = new QLabel(color.name(),this); 

60 label->setFixedWidth(60); 

61 label->setFont(QFont( M Courier M )); 

62 hbox- 〉 addWidget(label); 

63 

64 label = new QLabel(namelist[i] .name,this); 

65 hbox->addWidget(label); 

66 

67 retum(hbox); 

68 } 
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그림 ll-5.KColorDialog 창문 

7~25 행은 매개 색의 이름을 가진 namelist 배렬과 QColorGroup 으로부터 그것을 얻는데 
사용되는 ColorRole 값을 선 언한다 . 배 렬은 순환처 리 를 수행 할 때 코드를 간단화하기 위 하여 
정의되였다 . 

구성자는 35 행에서 시작한다 . 최상위용기는 수직칸이다 . 41 행에서 시작하는 순환고리는 
namelist 배 렬의 매 개 요소에 대하여 하나의 수평 칸을 구성 한다 . 43 행 의 addLayout() 호출에 따 
라 수직 칸에 매 개 수평 칸을 보관함으로써 그림 11-5 와 같이 현시한다 . 

47 행에서 시작하는 메쏘드 newColorLineO 는 매개 색 에 대하여 한번 호출된다 . 그때 넘 
겨진 인수는 namelist 배렬의 첨수로 사용된다 . 이 메쏘드는 수평칸을 만들고 거기에 3 개 표식 
자를 보관한다 . 첫째 표식자는 색자체를 현시하고 둘째 표식자는 색의 16 진값 , 그리고 셋째 
표식 자는 색 의 QColorGroup 이 름을 현 시한다 . 

52 행은 color() 메쏘드를 호출하여 표에서 렬거값을 사용함으로써 QColorGroup 로부터 
QColor 객체를 엄는다 . 색을 얻는 다른 방법은 색에 제공된 메쏘드들중의 하나를 호출하는것 
이다 . 실례로 다음 코드행은 Button 과 Midlight 색을 엄는데 사용될수 있다 . 

QColor bcolor = group.button(); 

QColor mcolor = group.midlight(); 

54 〜 57 행은 본문없이 표식 자를 만들지 만 namelist 배 렬 에서 현재 첨수로 설정 된 배경색 
을 가전다 . 색은 55 행에서 setBackgroundColor() 호출에 의해 표식자에 삽입된다 . 

59 〜 62 행은 색의 16 진이름을 보관하는 표식자를 만든다 . 이름은 59 행에서 name() 호출에 
의해 QColor 객체 에서 엄는다 . 수값들을 적 당히 현시하기 위하여 서체는 고정너 비서체 인 
Courier 로 변경하였다 . 

64 행과 65 행은 색의 QColorGroup 이름을 포함하는 셋째 표식자를 만든다 . 
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제 5 절. Qpalette 의 QColorGroup 들 


QPalette 객체는 3개의 QColorGroup 을 보관하는 용기이다. 모든 창문부품은 그것을 가지 
고있다. 매개 창문부품은 자체를 그릴 때 자기에게 할당된 QPalette 객체를 사용한다. 창문부 
품은 자체를 그릴 때마다 창문부품의 현재 상태에 일치하는 QColorGroup 을 사용한다. 3가지 
창문부품상태 를 표 11-3 에 서 설 명한다. 


표 11-3. 창문부품의 3가지 상태 


이름 

설명 

Normal 

이것은 기정상태이다. 

Active 

현재 초점을 가지고있는 창문부품은 Active 상태이다. 이 상태의 색들은 보 

통 Normal 상태와 같다. 

Disabled 

창문부품을 허용하지 않는다. 이 상태의 QColorGroup 은 보통 회색이거나 
또는 다른 방법으로 창문부품의 동면상태를 가리키도록 한다. 


앞의 실례프로그람의 51행에서 QWidget 메쏘드 colorGroup () 를 호출하여 현재 
QColorGroup 을 얻는다. 되 돌려진 실제의 QColorGroup 객체는 창문부품의 현재상태 에 의 해 결 
정되므로 3가지중 하나일수 있다. colorGroupO 메쏘드사용의 우점은 현재 QColorGroup 에서 자 
기가 요구하는 색을 엄는것이다. 

3개의 모든 QColorGroup 객체를 창문부품에 사용할수 있다. 다음 코드는 3개의 사본을 
얻기 위하여 창문부품이 사용할수 있다. 

QPalette myPalette = palette (); 

QColorGroup normalGroup = myPalette . normal (); 

QColorGroup activeGroup = myPalette . active (); 

QColorGroup disabledGroup = myPalette . disabled (); 


제 6 절. 몇가지 창문부품들의 색설정 

자체로 작성한 창문부품들의 색에 대한 완전조종뿐아니라 자기 프로그람의 매개 창문 
부품이 사용하는 모든 색들을 조종하는 창문부품용 색을 정의하는 방법이 있다. 선택적으로 
하나의 창문부품 혹은 창문부품나무안의 창문부품들 혹은 나무안에서 선택된 창문부품모임 
에 대하여 색을 설정하는 방법으로 색을 정의할수 있다. 

그것은 자기 창문부품들이 QPalette 의 색을 사용하도록 작성 하는것이다. 자기의 창문부 
품을 작성하여 항상 그것이 colorGroupO 메쏘드로부터 되돌아온 QColorGroup 로부터 색을 얻 
으면 자기 프로그람도 색에 대한 완전조종을 실행할수 있고 마음대로 그것들을 바꿀수 있다. 
사실상 KDE 와 Qt 에서 제공된 모든 창문부품들은 그 여러 부분을 채색할 때 QWidget 의 
QPalette 에서 제공된 색들을 사용한다. 




어떤 창문부품들이 영향을 받는가는 창문부품들을 통하여 조색판환경을 설정하도록 프 
로그람을 선택하는 방법에 달려있다. 색환경뿐아니라 서체환경에 영향을 주는 선택들을 표 
11-4 에 보여준다. 

표 11-4. 조색 판과 서 체 변경 이 자식창문부품들에 주는 영 향 


이름 

설명 

NoChildren 

이 창문부품의 조색판이나 서체변경은 자식창문부품들에 영향을 주지 않 

는다. 

AllChildren 

이 창문부품의 조색판이나 서체변경은 모든 자식창문부품들에도 적용된 

다. 

SamePalette 

이 창문부품의 조색판이나 서체변경은 서체 또는 조색판을 설정하지 않 

은 모든 자식창문부품들에 적용된다. 

SameFont 

SamePalette 와 같다. 


특별한 도색을 요구하는 창문부품을 가지고있으나 그 단일창문부품에 색을 적용하려고 
한다면 그것이 사용할 QPalette 의 특별한 판을 만들수 있다. 42가지 색 (3 개의 QColorGroup 각 
각에 14가지 색)을 모두 지정함으로써 모든것을 새로 만들수 있으나 현존 QPalette 의 수정판 
을 창조하려는 경우가 더 많다. 다음 실례는 이것을 수행하는 방법을 보여준다. 

1 /* colorone.cpp */ 

2 #include < kapplication . h > 

3 #include < qlabel . h > 

4 #include < qpushbutton . h > 

5 #include < qcolor . h > 

6 #include < qlayout . h > 

7 #include ’’ colorone . h ” 

8 

9 int main(int argc , char ** argv ) 

10 { 

11 KApplication app ( argc , argv , ’’ colorone "); 

12 ColorOne colorone ; 

13 colorone . show (); 

14 app . setMainWidget (& colorone ); 

15 return ( app . exec ()); 

16} 

17 ColorOne :: ColorOne(QWidget ^ parent,const char * name ) 

18 : QWidget ( parent , name ) 








19 { 

20 QString str; 

21 QLabel *label; 

22 QPushButton ^button; 

23 

24 QPalette newPalette = palette().copy(); 

25 

26 QColorGroup normalGroup = newPalette.normal(); 

27 normalGroup. setColor(QColorGroup :: ButtonT ext, 

28 QColor( n white M ))； 

29 normalGroup.setColor(QColorGroup::Button, 

30 QColor ( ， ’ blue，，)); 

31 normalGroup.setColor(QColorGroup::Foreground, 

32 QColor( M red M )); 

33 newPalette. setNormal(normalGroup); 

34 

35 setPalettePropagation(AllChildren); 

36 setPalette(newPalette,TRUE); 

37 

38 QVBoxLayout *vbox = new QVBoxLayout(this, 15); 

39 

40 button = new QPushButton("The Top Button",this); 

41 vbox->addWidget(button); 

42 

43 label = new QLabel( M The Label in the Middle",this); 

44 vbox->addWidget(label); 

45 

46 button = new QPushButton("The Bottom Button”,this); 

47 vbox->addWidget(button); 

48 

49 resize(10,10); 

50} 

24 행의 copy () 호출은 현재 능동인 QPalette 를 복제 한다 . 새로운 QPalette 는 원본의 색 값들 
을 모두 포함하며 원본에 어떠한 영향을 주지 않고 변경할수 있다 . copyO 호출은 조색판의 사 
본을 만든다 . QPalette 객체들이 커질수 있으므로 매개 창문부품은 자기의 비공개사본을 만들 
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지 않고 사용하는 조색 판에 로의 참고를 유지 한다. 그러 므로 palette () 메 쏘드가 QPalette 객 체(많 
은 창문부품들에서 사용되는것일수 있다:)의 참고를 돌려주고 자기가 알고있는 그 창문부품 
들만으로 변경을 제한하려고하므로 copy *} 메쏘드를 사용하여 그 사본을 작성하는것이 제일 
좋다. 이것은 자기의 개별적인 QPalette 실례라고 생각할수 있는 사본이다. 

QColorGroup 은 26행에서 새로운 QPalette 로부터 얻는다. 27~32행은 setColor () 를 호출하 
여 색그룹에서 현존색정의중 3개를 교체한다. 이 색들중 2개는 특별히 단추용이고 다른 색 
은 모든 창문부품들에서 전경색을 변경하기 위하여 설정된다. 33행의 setNormal () 호출은 변경 
된 색그룹을 새로운 QPalette 에 보통색그룹으로 보관한다. 

35행의 setPalettePropagation () 호출은 모든 자식창문부품들이 새로 변경한 QPalette 를 사용 
할수 있도록 창문부품환경 을 구성한다. 36행의 setPaletteO 호출은 새 로운 조색 판을 이 창문부 
품과 그의 모든 자식창문부품들에 의 해서 사용되는것으로 확립한다. 


38〜47행은 그림 11-6 에 보여준 창문부품배치를 만든다. 표식자는 그 본문에 표준전경 
색을 사용하므로 그것은 적색으로 된다. 누름단추의 본문은 백색으로 그려지고 단추의 배경 
색은 푸른색 이다. 이 색들은 단추의 상태가 표준으로부터 변화될 때까지(마우스로 단추에 들 
어감으로써) 그 단추에서 유지된다. 



그림 11 -6 . 오직 부모창문부품의 색만 변경 

전달이 기정값 SamePalette 로 지정하면 꼭같은 조색판을 가지는 모든 자식 창문부품들의 
조색판은 갱신된것으로 바뀐다. 이것은 일부 자식창문부품들에 새로운 조색 판을 적 용할수 
있게 하지만 다른것들은 그대로 남겨둔다. 그러기 위하여 새로운 조색판을 만들고 그것을 
수정할수 있게 하려 는 모든 창문부품들과 부모창문부품에 할당한다. 그때 부터 SamePalette 설 
정을 사용하는 부모창문부품에 새로운 조색판을 할당하면 오직 그 지정된 창문부품들만 자 
기의 변경된 조색판들을 가지게 한다. 


제7절. 사용자의 색만들기에 QPalette 의 사용 

어떤 형식의 저준위도형을 처리하는 자기의 창문부품을 만들 때는 색을 선택할 필요가 
있다. 필요하면 사용하려는 정확한 색을 지정하거나 QPalette 에 보관된것들을 꺼낼수 있다. 
미리 정의된 QPalette 색들을 사용하면 응용프로그람에서 색들이 변경될 때 자기 창문부품의 
색들도 변화된다는 우점을 가전다. 
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다음 실례는 창문부품이 QPalette 에 보관된 색을 사용하는 방법을 보여준다 . 

1 /* usepalette.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include "usepalette.h” 

5 

6 int main(int argc, char **argv) 

7{ 

8 KApplication app(argc, argv, "usepalette"); 

9 UsePalette usepalette; 

10 usepalette.show(); 

11 app.setMainWidget(&usepalette); 

12 return (app.exec()); 

13} 

14 UsePalette : :UsePalette(QWidget *parent,const 

15 char *name) : QWidget(parent,name) 

16 { 

17 setFixedSize(375,250); 

18} 

19 void UsePalette::paintEvent(QPaintEvent *) 

20 { 

21 QColorGroup group = colorGroup(); 

22 QColor midColor = group.color(QColorGroup :: Mid); 

23 QColor lightColor = group.color(QColorGroup: :Light); 

24 QBrush midBrush(midColor); 

25 QBrush lightBrush(lightColor); 

26 QPainter p; 

27 p.begin(this); 

28 p.fillRect(75,50,1 50, 100,midBrush); 

29 p.fiURect(150 ， 100 ， 150 ， 100 ， lightBrush) ; 

30 p.end(); 

31} 

UsePalette 창문부품을 그려 야 할 때마다 19 행 의 paintEvent 호출이 있다 . 

21 행 의 QWidget 메 쏘드 colorGroupO 호출은 현재 의 QColorGroup 을 되 돌려 준다 . 되 돌려진 
실제색그룹은 창문부품의 상태에 따라 변화하므로 그룹으로부터 색을 사용하면 자기 창문부 
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품의 색들은 그 현재상태를 반영하여 변화된다. 

22 행과 23 행은 QColorGroup 의 color() 을 호출하여 그리기에 사용할 2 가지 색객체를 돌려 
준다. 그다음에 색들은 4 행와 25 행 에서 사용되 여 한쌍의 QBrush 객처 U 매개 색 에 하나씩)을 만 
든다. 이 객체들은 28 행과 29 행에서 그림 11-7 에 보여준 직 4 각형들을 그러는데 사용된다. 이 
paintEvent() 메 쏘드와 QPainter 사용방법 에 대한 자세 한 정보는 12 장에 있다. 



그림 11-7. 외 부적 으로 수정할수 있는 색 들의 실 례 

요 약 

KDE 와 어에서 정의된 특별한 색부류의 우점들을 리용함으로써 완전한 응용프로그람의 
색채가 풍부한 모양을 직접 조종，설정，그리고 변경할수 있다. 이 장은 다음과 같은것을 설 
명 하였다. 

• 사용할수 있는 색수는 주어진 체계의 하드웨 어능력 에 달려있다. 유한개의 사용가능색 
이 있을뿐아니라 임의의 시각에 보통 그 부분집합만 사용가능하다. 

• QColor 객체는 하드웨어에 의존하지 않는 색에 대한 원색정보를 가전다. QColor 객체의 
모양은 한 체계에서 다른 체계에로 넘어갈 때 변하지만 색들은 그 차이가 보통 문제로 되지 
않을 정도로 아주 근사하다. 

• 색 들은 그룹으로 묶고 그룹들을 조색 판에 수집한다. 그 모두는 응용프로그람의 매 개 
창문부품이 그 매개 부분을 그리 거 나 칠할 때 정 확한 색을 쉽 게 선택하도록 환경 을 구성한 
다. 

• 응용프로그람이 사용하는 색은 기정색모임으로부터 얻을수 있고 명백히 적-록-청수값 
들에 의해 정의되고 미 리 정의된 색이름목록으로부터 얻거 나 응용프로그람의 사용자가 환경 
의 부분으로 포함할수 있다. 





제 12 장. QPainter 에 의한 그리기와 색칠하기 


학습내용 

한번에 한 화소를 리용하여 도형화상을 그리기 
직4각형과 타원과 같은 도형들을 그리고 색칠하기 
단일직선과 복합직선의 그리기 
호와 환4각형과 같은 특수도형만들기 
현시창문에 픽 스매 프를 복사하기 

이 장에서는 도형처 리와 관련한 기술을 론의하며 화소，직선，곡선，본문과 령역을 도색 
하는데 필요한 기본함수들의 실례들을 설명한다. 

기본적 인 도형처 리기술은 물론 XII 도형처 리서고에 의존한다. Qt 쏘프트웨어는 C ++ 클라 
스집합안에 XI I 함수들을 포함하므로 XI I 에 익 숙되 면 모든것 이 처 음에 는 좀 낡아보일 수 있 
지만 QWidget 에 직접 사용될수 있는 QPainter 가 있다. 

제1절. QPaintDevice 에 화소를 그리기 

QPaintDevice 에 화소들을 그리 거 나 칠하는데 QPainter 객 체 를 사용할수 있다 . QPaintDevice 
는 표 12-1 에 서술한 클라스들에 의해 계승되는 기초클라스이다. 

QPainter 객체는 그리기와 칠하기를 모두 수행한다. QPainter 객체는 QPen 객체와 QBrush 객 
체 를 포함한다. QPen 객 체 는 화소그리 기 와 직 선그리 기 

그리고 본문에, QBrnsh 객체는 구역을 칠하는데 사용된다. 프로그람이 때때로 그것들을 
바꿀수 있지만 오직 하나의 QPen 과 하나의 QBrnsh 가 임의의 시간에 QPainter 객체내부에 존 
재하게 된다. 

표 12-1. QPainter 도형 그리기 지 령을 받아들이 는 클라스들 


클라스 

설명 

QPicture 

QPicture 객체는 QPainter 로부터 도형그리기지령을 받아들이고 그것들을 기록 
한다. 지 령들은 그후에 다른 QPaintDevice 객체 에 그려질수 있으며 또한 후에 

회 복을 위해 파일 에 써 넣 을수 있다. 

QPixmap 

QPainter 는 QPixmap 객체에 직접 그리거나 칠하는데 사용될수 있다. 현존 픽 
스매프도형을 변경하려고 하거나 그리려는 도형 이 너무 복잡하지만 한번 수 

행하려고 한다면 이것을 리용한다. 

QPrinter 

QPrinter 객체에 그리는 도형을 postscript 로 변환되고 인쇄 스풀러 ( lp , lpr , 또는 
어떤것 이 든지)에 보내진다. QPrinter 는 폐지작성 을 위 한 메쏘드 즉 폐지 크기 
설정，현재폐지를 인쇄기에 보내기，방향설정 등을 가지고있다. 

QWidget 

모든 현시가눙객체는 QWidget 이므로 얼마든지 현시가눙객체에 직접 그리고 
도색할수 있다. 빈 창문부품들은 창문부품이 이미 자기 소유(단추의 본문과 
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같은)의 도형을 가지고있으면 창문부품의 도형은 자기의것과 충돌할수 있 

_쓰_ 

이 장은 QPainter 메쏘드들의 호출애 의한 도형처리를 설명하기 위하여 QWidget 객체를 

사용한다. 그리 기 자체 는 창문부품을 그려야(또는 다시 그려야) 할 때 마다 호출되 는 
paintEventO 라는 메쏘드에서 수행된다. 이 메쏘드는 실행을 시작한 프로그람의 로출，창문크 
기의 변경，어두운 창문이 제거될 때마다 호출된다. 이 메쏘드를 호출할 때마다 창문은 이미 
배경색으로 지워졌으므로 어떤 지우기도 필요없다. 프로그람이 하여야 할 일은 그림을 그리 
는것 이 다. 내부적으로 그리 기 는 이 미 완충되 여있고 화면 이 갱신될 때 깜빡임 이 없도록 현시 
기에 복사된다. 


제2절. 직4각형 


많은 도형들은 QPainter 를 사용하여 그릴수 있으며 그것들을 그리는 방법은 수십가지 
있다. 이 절은 간단한 직4각형을 그리고 도색하는 기본방법들의 실례를 제공함으로써 어도 
형처리의 기초를 보여준다. 다음 실례프로그람은 빈 창문부품을 만들고 그 창문에 직4각형 
을 그린다. 

DrawRectangle 머 리 부파일 

1 /* drawrectangle.h */ 

2 #ifndef DRAWRECTANGLE_H 

3 #define DRAWRECTANGLE_H 

4 

5 #include < qwidget . h > 

6 

7 class DrawRectangle : public QWidget 

8{ 

9 public : 

10 DrawRectangle(QWidget * parent =0 ,const char * name =0); 

11 protected : 

12 virtual void paintEvent(QPaintEvent *); 

13}； 

14 

15 #endif 

DrawRectangle 클라스는 응용프로그람의 제 일 웃준위창문부품으로 사용되 는 창문부품이 
다. 가상메쏘드 paintEventO 는 QWidget 클라스의 메쏘드를 재정의하며 창문부품의 표면을 칠 
하거나 다시 칠할 필요가 있을 때마다 호출된다. 

DrawRectangle 





1 /* drawrectangle.cpp */ 

2 #include < kapplication . h > 

3 #include < qpainter . h > 

4 #include " drawrectangle . h " 



8 KApplication app ( argc , argv , " drawrectangle "); 

9 DrawRectangle drawrectangle ; 

10 drawrectangle . show (); 

11 app . setMainWidget (& drawrectangle ); 

12 return ( app . exec ()); 

13} 

14 DrawRectangle :: DrawRectangle(QWidget * parent,const 

15 char * name ) : QWidget ( parent , name ) 

16 { 

17 setFixedSize (400,200); 

18} 

19 void DrawRectangle :: paintEvent(QPaintEvent *) 

20 { 

21 QPainter p ; 

22 p . begin ( this ); 

23 p . drawRect (50,50,300,100); 

24 p . end (); 

25} 

14 행 에 서 시 작하는 구성 자는 고정 크기창문을 가지 는 창문부품을 만든다. 도형 은 오직 
창문이 실현된 후에(즉 그것은 실제로 화소값들을 보관할 장소를 가진다) 현시기에 배치될 
수 있기때문에 구성자에 의해 그려지는 그림은 없다. 

paintEvent () 메쏘드는 현시기를 재생하여야 할 때는 언제나 호출된다. 즉 창문은 사용자 
가 무엇을 그렸는가를 기억하지 않으며 자동적으로 그것을 교체한다. 프로그람은 창문을 다 
시 그릴 준비 가 되 여있 어 야 하며 이 메 쏘드가 호출될 때 마다 그것 을 새 로 그려야 한다. 보 
통 창문부품의 유일한 부분이 로출되여도 모든것을 그리는데 드는 실제비용은 없지만 도형 
이 복잡하고 도형 을 그리 는데 일정한 시 간이 요구되 면 그리 기 에 영 향을 받는 구역 만으로 제 
한할수 있다. 이러한 제한을 잘라내기 ( clipping ) 라고 부론다. 

내부적으로 QPainter 객체는 QPen 객체를 사용하여 화소와 직선을 그린다. 기정 QPen 은 흑 




색이고 1 화소너비로 선을 그린다. 

19 행의 메쏘드 paintEventO 은 그림 12-1 에 보여주는 직 4 각형을 그린다. QPainter 객체는 
21 행에서 만들어진다. 이 QPainter 객체는 창문을 가지지 않으므로 그리는데 사용될 수 없다. 
22 행의 begin() 호출은 QPainter 를 련결하고 직 4 각형의 그리기는 23 행에서 drawRect() 호출에 의 
해 발생한다. drawRect() 에 넘긴 인수는 직 4 각형의 왼쪽웃구석의 x 와 y 자리표이고 그 뒤에 너 
비와 높이가 온다. 화상을 완전히 그렸을 때(이 경우에 간단한 직 4 각형) endO 메쏘드호출이 
이루어지고 QPainter 와 QWidget 가 분리된다. 



그림 12-1. 창문중심에 그려지는 직 4 각형 

begin() 과 end() 메쏘드들을 모두 호출하여야 하고 구성자인수로서 그리기목표를 지정함 
으로써 구성자와 해체자가 그것을 하게 할수 있다. 다음 메쏘드는 이전것처럼 정확히 동작 
한다. 사용자가 어느것을 사용하는가는 개인적인 취미문제이다. 
void DrawRectangle2 :: paintEvent(QPaintEvent *) 

{ 

QPainter p(this); 
p.drawRect(50,50,300,100); 

} 

이 실례의 구성자안에서 begin 호출이 이루어지고 end() 호출은 해체자안에서 이루어진다. 
(그것은 QPainter 가 메 쏘드의 끝에서 범위 밖으로 벗어날 때 자동적으로 호출된 다.) 

알아두기: begin() 메쏘드가 호출될 때마다 QPainter 객체는 완전히 초기화되므로 펜과 
솔들로 QPainter 를 미 리 설치한 다음 그것을 리 용하여 여 러 창문부품들을 그리 는 

방법은 없다. _ 

직 4 각형의 칠하기는 그것을 그리는것과 좀 다트다. 다음 실례는 이전 실례와 같은 기본 
치수들을 사용하지만 그림 12-2 에 보여준 색칠한 직 4 각형을 만든다. 

1 /* fillrectangle.cpp */ 

2 #include <kapplication.h> 








3 #include <qpainter.h> 

4 #include M fillrectangle.h" 

5 

6 int main(int argc, char **argv) 

7{ 

8 KApplication app(argc, argv, "fillrectangle"); 

9 DrawRectangle fillrectangle; 

10 fillrectangle. show(); 

11 app.setMainWidget(&fillrectangle); 

12 return (app.exec()); 

13} 

14 DrawRectangle: :DrawRectangle(QWidget *parent,const 

15 char *name) : QWidget(parent,name) 

16 { 

17 setFixedSize(400,200); 

18} 

19 void DrawRectangle :: paintEvent(QPaintEvent *) 

20 { 

21 QBrush brush(QColor( “black” )); 

22 QPainter p; 

23 p.begin(this); 

24 p.fillRect(50,50,300,100,brush); 

25 p.end(); 

26} 



그림 12-2. 창문중심의 색칠한 직 4 각형 







그러기는 19 행에서 시작하는 paintEvent() 에서 실행된다 . 그리기는 QPen 객체(기정은 흑색 
펜)을 가지고 수행되지만 도색은 솔(기정솔은 칠하지 않는다)을 가지고 수행한다 . 그러므로 
paintEventO 메쏘드의 21 행은 흑색화소들로 구역의 모두를 도색하는데 사용할 QBrnsh 객체를 
만든다 . 

QPainter 객체는 22 행에서 만들어지고 23 행에서 창문부품에 련결된다 . 24 행의 fillRectO 호 
출은 초기의 drawRectO 와 같이 직 4 각형의 왼쪽웃구석의 표와 y 자리표와 직 4 각형의 너비와 높 
이를 요구한다 . 그것은 또한 직 4 각형을 칠하는데 사용하는 솔을 요구한다 . 

직 4 각형의 그리기와 도색을 모두 할수 있다 . 다음 실례는 우선 흰솔로 직 4 각형을 도색 
한 다음 기정흑색펜으로 백색구역의 륜곽을 그린다 . 

void FillRectangle2 :: paintEvent(QPaintEvent *) 

{ 

QBrush brush(QColor("white "))； 

QPainter p; 
p.begin(this); 

p.fillRect(50,50,300,100,brush); 

p.drawRect(50,50,300,100); 

p.end(); 

} 

결과는 그림 12-3 에 보여준다 . 직 4 각형은 그러는 직 4 각형의 외부경계가 색칠하는 직 4 각 
형 의 외 부경계와 정 확히 일치하므로 그리 기전에 도색되 여 야 하며 직 4 각형 을 도색하는 동작 
은 이미 거기에 있는것은 모두 지워버린다 . 



그림 12-3. 직 4 각형의 도색과 륜곽그러기 

다른 수법도 있다 . 모든 그리기메쏘드는 도형륜곽그러기와 칠하기에 모두 사용될수 있 
다 . 륜곽그리기에는 펜이 사용되지만 칠하기에는 솔이 사용된다 . 그림 12-3 에 보여준 직 4 각 
형 은 또한 다음 paintEventO 메 쏘드에 의해 생 성 될 수 있 다 . 






void FillRectangle 3 :: paintEvent(QPaintEvent *) 

{ 

QBrush brush 災 Color (" white ")) ; 

QPainter p ; 

p . begin (仕 lis ); 

p . setBrush ( brush ); 

p . drawRect (50,50,300,100); 

p . end (); 

} 

이 실례에서 기정 QPen (흑색，가는 선)은 륜곽선을 그리는데 사용되지만 기정 QBrush 는 
없으므로 그것을 만들어서 도형을 칠하기전에 QPainter 에 할당하여야 한다. drawRectO 호출은 
우선 솔색으로 직4각형구역을 칠하고 그다음에 펜으로 그 륜곽을 그린다. 

제3절. 펜 

QPen 으로 선을 그리기 위하여서는 3가지 속성 즉 색, 너비, 그리고 점 또는 사슬폐턴을 
가지고 있어야 한다. 기정펜은 가장 작은 선 (1 화소너비의 선)을 그러는 0의 너비를 가지고있 
다. 이것은 대체로 선너비를 1로 설정한것과 갈다. 0의 화소너비로 그린 선은 그림의 확장 
에 관계 없 이 정 확히 1화소너 비 를 유지한다. 그렇 지 만 1이 상의 화소너 비 로 그린 선은 그림 을 
확대 혹은 축소할 때 그 두께가 변한다. 

다음 실례는 그림 12-4 에 보여 준 창문을 현시한다. 그것 은 흑색으로 2화소너 비 의 6가지 
사용가능한 형식의 직선을 그린다. 첫째 형식 ( NoPen ) 은 그 어떤 선도 그리지 않는다. 실례로 
직4각형내 부를 칠하고 직4각형 의 륜곽을 그리 지 않으려 면 NoPen 형 식 을 사용할수 있다. 



그림 12-4. 6가지 QPen 직선형식 










알아두기 : 이 실례는 drawLineO 을 사용하여 각이한 직선형식을 보여주지만 직선형식은 
drawArc(), drawRect() 그리고 drawPolyline() 를 비롯하여 모든 그리기 메 쏘드에 적용된다 . 
PenStyles 머 리 부파 일 

1 /* penstyles.h */ 

2 #ifndef PENSTYLES_H 

3 #define PENSTYLES_H 

4 

5 #include <qwidget.h> 

6 #include <qlabel.h> 

7 

8 class PenStyles: public QWidget 

9{ 

10 public: 

11 PenStyles(QWidget *parent=0,const char *name=0); 

12 private: 

13 QLabel *label[6]; 

14 QWidget *widget[6]; 

15 protected: 

16 virtual void paintEvent(QPaintEvent *); 

17 }； 

18 

19 #endif 

PenStyles 클라스는 현시에 사용되는 표식자와 창문부품들의 배렬들을 포함한다 . 
paintEventO 역호출메쏘드가 창문부품들의 호출을 요구하기때문에 창문부품들의 배렬을 클라 
스의 부분으로서 포함할 필요가 있다 . 

PenStyles 

1 /* penstyles.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include <qlayout.h> 

5 #include "penstyles.h M 

6 

7 struct pstyleStruct { 

8 QString name; 

9 Qt::PenStyle style; 
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10 } pstyle[6] = { 

11 {"NoPen", Qt::NoPen }, 

12 {"SolidLine", Qt::SolidLine }， 

13 {"DashLine" ， Qt::DashLine }, 

14 {"DotLine", Qt: : DotLine }, 

15 {"DashDotLine", Qt::DashDotLine }, 

16 { M DashDotDotLine M , Qt: : DashDotDotLine } 

17 }； 

18 

19 int main(int argc, char **argv) 

20 { 

21 KApplication app(argc, argv,” peristyles” ); 

22 PenStyles penstyles; 

23 penstyles.show(); 

24 app.setMainWidget(&penstyles); 

25 return (app.exec()); 

26} 

27 PenStyles::PenStyles(QWidget *parent,const 

28 char *name) : QWidget(parent,name) 

29 { 

30 QVBoxLayout *vbox = new QVBoxLayout(this,0,3 )； 

31 

32 for(inti=0; i<6; i++) { 

33 label[i] = new QLabel(pstyle[i].name,this); 

34 vbox->addWidget(label[i]); 

35 widget[i] = new QWidget(this); 

36 widget[i]->setFixedHeight(20); 

37 widget[i]->setFixedWidth(200); 

38 vbox->addWidget(widget[i]); 

39 } 

40 resize(10,10); 

41} 

42 void PenStyles :: paintEvent(QPaintEvent *) 

43 { 

44 QColor black("black"); 
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45 QPainter p; 

46 for(int i=0; i<6; i++) { 

47 p.begin(widget[i]); 

48 QPen pen(black,2 ， pstyle[i].style); 

49 p.setPen(pen); 

50 p.drawLine(10,5 ， 190,5); 

51 p.end(); 

52 } 

53} 

7 〜 17 행의 구조체배렬은 편리상 간단히 각이한 직선형식들의 이름과 값들을 보관한다 . 형식 
들의 이름은 qnamespace.h 에서 정의되는데 그것은 Qt 클라스를 선언한다 . QObject 와 일부 다른 중요 
한 클라스들이 Qt 를 계승하므로 공개적으로 그것을 포함할 필요는 거의 없다 . 

27 행에서 시작하는 구성자는 수직칸을 리용하여 12 개 창문부품의 렬을 가진다 . 6 개 
QLabel 창문부품과 6 개 일반적인 QWidget 창문부품이 있다 . 표식자들은 직선형식의 이름을 현 
시하는데，그리고고 QWidget 는 선을 현시 하는데 사용된다 . 32 행에서 시작하는 순환은 표식자 
와 창문부품들을 모두 만들고 그 크기의 설정 , 수직칸에 그것들의 추가，클라스의 배 렬에 그 
것들의 참고를 보관한다 . 

직선의 실제그리기는 창문을 그려야 할 때마다 호출되는 24 행의 paintEventO 메쏘드에서 수행 
된다 . 나머지 일은 직선을 그리는것이다 . 46 행에서 시작하는 순환은 6 개 창문부품의 창문에 단일직 
선을 그린다 . 그리기를 위하여 47 행에서 beginO 호출이 이루어지고 직선을 받아들이는 창문부품에 
QPainter 객체를 할당한다 . 48 행은 적합한 형식의 QPen 을 만들고 49 행은 setPenO 을 호출하여 모든 그 
리기에서 사용할 새로운 펜을 설정한다 . 직선은 50 행의 drawLineO 호출에 의해 그러진다 . 순환의 끝 
에서 end )} 메쏘드가 호출되여 이 창문부품과 QPainter 를 분리하므로 그것은 순환고리의 꼭대기에서 
배렬안의 다음 창문부품에 사용될수 있다 . 

알아두기 : QLabel 창문부품의 본문은 구성자에서 삽입되지만 메쏘드 paintEventO 를 호출 
할 때까지 아무것도 그려지지 않는다 . 사실상 프로그람이 표식자에 본문을 삽입하더 
라도 그것은 실제로 paintEventO 에로의 역호출이 있을 때까지 그리지 않는다 . 


제4절. 표준솔 

QBrush 로 령역을 칠하기 위하여서는 2 가지 속성 즉 색과 폐턴이 있어 야 한다 . 기정색은 
흑색이고 기정폐턴은 SolidPattem 이다 . 15 가지의 미리 정의된 폐턴을 사용할수 있지만 또한 
자체로 만들수 있다 . 다음 프로그람은 그림 12-5 에 보여준것과 같이 미리 정의된 폐턴들을 
현시 한다 . 
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그림 12-5. 15 개의 미리 정의한 솔형식 

BrushStyles 머 리 부파 일 

1 /* brushstyles.h */ 

2 #ifodef BRUSHSTYLES_H 

3 #defme BRUSHSTYLES_H 

4 

5 #include <qwidget.h> 

6 

7 class BrushStyles: public QWidget 

8 { 

9 public: 

10 BrushStyles(QWidget *parent=0,const char *name=0); 

11 protected: 

12 virtual void paintEvent(QPaintEvent *); 

13 }； 

14 
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15 #endif 

BmshStyles 클라스는 빈 창문부품이므로 그 창문에 본문과 색칠한 직 4 각형들을 둘다 그 
릴수 있다 . 

BrushStyles 

1 /* brushstyles.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include <qlayout.h> 

5 #include "brushstyles.h” 

6 

7 struct bstyleStruct { 

8 QString name; 

9 Qt::BrushStyle style; 

10 } bstyle[15] = { 

11 { "NoBrush", Qt: : NoBrush }, 

12 {"SolidPattem", Qt::SolidPattem }, 

13 {’’Dense 1 Pattern”, Qt: : Dense 1 Pattern }, 

14 { ,, Dense2Pattem", Qt::Dense2Pattem }, 

15 {"Dense3Pattem", Qt: : Dense3Pattem }, 

16 {"Dense4Pattem ,, ? Qt::Dense4Pattem }, 

17 {"Dense5Pattem n , Qt: : Dense5Pattem }, 

18 {"Dense6Pattem ,, ? Qt::Dense6Pattem }, 

19 { M Dense7Pattem n , Qt: : Dense7Pattem }, 

20 {"HorPattem", Qt: : HorPattem } ， 

21 { "VerPattem", Qt: : VerPattem } ， 

22 {"CrossPattem", Qt::CrossPattem }, 

23 {"BDiagPattem", Qt::BDiagPattem }, 

24 {"FDiagPattem", Qt::FDiagPattem }, 

25 { "DiagCrossPattem", Qt: : DiagCrossPattem } 

26}; 

27 

28 int main(int argc, char **argv) 

29 { 

30 KApplication app(argc, argv, "brushstyles"); 

31 BrushStyles brushstyles; 
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32 brushstyles.show(); 

33 app.setMainWidget(&brushstyles); 

34 return (app.exec()); 

35} 

36 BrushStyles::BrushStyles(QWidget *parent,const 

37 char *name) : QWidget(parent,name) 

38 { 

39 setFixedSize(280,455); 

40} 

41 void BrushStyles: : paintEvent(QPaintEvent *) 

42 { 

43 int xText = 10; 

44 intxFill= 130; 

45 int yText = 25; 

46 intyFill= 10; 

47 QColor black("black"); 

48 QPainter p(this); 

49 for(inti=0; i<15; i++) { 

50 QBrush brush(black,bstyle[i].style); 

51 p. setBrush(brush); 

52 p.drawText(xText,yText,bstyle[i] .name); 

53 p.drawRect(xFill,yFill, 130,20); 

54 yText += 30; 

55 yFill += 30; 

56 } 

57} 

7 〜 26 행에서 정의된 구조체배렬은 미리 정의된 15 가지 형식들의 개개의 이름과 값들을 
보관하기 위 한것 이 다 . 형 식 이 름은 qnamespace.h 에 서 정 의 된 다 . 

36 행에서 시작하는 구성자는 본문과 직 4 각형을 모두 포함하는 크기가 고정인 창문을 
설 정 한다 . 

41 〜 57 행의 paintEvent() 메 쏘드는 창문을 색칠할 필요가 있을 때마다 호출된 다 . xText 와 
yText 값들은 본문의 첫 글자위치를 지정하지만 xFill 과 yFill 은 색칠하려는 직 4 각형의 왼쪽웃 
구석의 위치를 결정한다 . 49 행에서 시작하는 순환은 매개 색칠형식에 대하여 한번씩 실행한 
다 . 50 행은 미리 정의된 형식들중에서 하나를 선택하여 QBrush 객체를 만들고 51 행은 
QPainter 에 그것을 설정한다 . 52 행 에서 drawText() 호출에 의해 본문을 그린다 . 직 4 각형 구역 은 
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53 행에서 drawRect() 호출에 의해 색칠해진다 . 직 4 각형은 기정흑색 QPen 이 여전히 유효하므로 
흑색으로 색칠되고 륜곽이 그려지며 새 견본의 QBrnsh 가 추가된다 . 


제5절. 사용자정의솔만들기 


령역을 채우기 위하여 QBrush 는 작은 픽스매프를 만들고 창문에 그것을 타일모양으로 
붙인다 . 그러므로 자체의 색칠패턴을 QPixmap 형식으로 지정하는것은 간단한 문제이다 . 다음 
프로그람은 창문의 직 4 각형령역을 칠하기 위하여 픽스매프를 사용한다 . 

BrushCustom 

1 /* brushcustom.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include <qlayout.h> 

5 #include M brushcustom.h" 


7 static const char *mypattem[] = { 


8 

"16 16 4 1 "， 

9 

" c blue", 

10 

，，. c white", 

11 

"x c red", 

12 

"y c green", 

13 

"yy.yy", 

14 

"yy.yy", 

15 


16 


17 

".", 

18 

". "， 

19 

" ..… X ", 

20 

’’ xx)( ’’ 

21 

"... xxxxx "， 

22 

" .. xxxxxxx ’’ 

23 

..xxxxxxxxx" 

24 


25 


26 



27 


'yy.yy", 
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28 "yy.yy ，， 

29}; 

30 

31 int main(int argc, char **argv) 

32 { 

33 KApplication app(argc, argv,” brushcustom” ); 

34 BrushCustom brushcustom; 

3 5 brushcustom. show(); 

36 app.setMainWidget(&brushcustom); 

37 return (app.exec()); 

38} 

39 BrushCustom: : BrushCustom(QWidget ^parent,const 

40 char *name) : QWidget(parent,name) 

41 { 

42 se 抑 xedSize(220 ， 120); 

43} 

44 void BrushCustom: : paintEvent(QPaintEvent *) 

45 { 

46 QBrush brush; 

47 QPixmap pixmap(mypattem); 

48 brush. setPixmap(pixmap); 

49 

50 QPainter p(this); 

51 p. setBrush(brush); 

52 p.drawRect(20,20,180,80); 

53} 

려과기로 사용될 픽스매프는 7 〜 29 행에 XPM 형식으로 있다 . 

참고 : 9 장은 XPM 형 식 과 그 사용방법 에 대하여 설명 하였다 . | 

39 행 에서 시 작하는 구성자는 120X220 화소의 고정 크기 로 창문부품의 창문을 설정한다 . 
그리 기 는 44 행 의 paintEvent() 에서 진행된다 . 47 행 은 픽 스매프정 보를 사용하여 QPixmap 객 
체 를 만들고 48 행 은 setPixmap() 를 호출하여 QBrush 에 픽 스매 프를 설 정한다 . 픽 스매 프설 치 에 
서는 솔형식을 CustomPattem 으로 설정하는데 이 값은 오직 픽스매프에만 사용되므로 앞의 
실례에 포함되지 않았다 . 이 실례가 생성하는 창문은 그림 12-6 에 보여주었다 . 일단 솔이 정 
의되 고 QPainter 에 설정되 면 그것을 다른것으로 변경할 때까지 색 칠에 사용한다 . 
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그림 12-6. 사용자정 의 솔을 리 용한 직 4 각형칠하기 
타일붙이기는 그리고있는 실제도형의 위치에 관계없이 수행된다 . 이 장의 마지막에 설 
명하겠지만 원점은 이동될수 있으나 왼쪽웃구석우의 기정원점은 첫째 타일이 놓이는곳이고 
다른 모든 타일은 그 린접 에 붙여 진다 . 원점타일을 볼수 있게 할 필요는 없지 만 모든 다른 
타일들의 위치는 그로부터 평가된다 . 그림 12-6 을 보고 프로그람의 XPM 자료와 그것을 비교 
한다면 왼쪽웃타일의 왼쪽웃부분이 잘리운것을 볼수 있다 . 


제6절. QPaintDevice 의 측도 


창문크기가 변할 때 창문에 그러진 도형의 크기가 변경되거나 환경에 적응되여야 할 
필요가 자주 생긴 다 . 클라스 QPaintDeviceMetrics 는 QPaintDevice 의 현재 크기 (및 기타 정보)를 
결정하는데 사용한다 . 다음 실례프로그람은 QPaintDeviceM 的 ics 객체의 정보를 사용하여 창문 
에 도색하는 도형들의 위치와 크기를 변화시킨다 . 그림 12-7 과 12-8 에 보여준것처럼 본문은 
창문에서 수직방향으로 균일한 간격을 유지하며 배경에서 흰직 4 각형은 창문에 맞게 그자체 
의 모양을 변 경한다 . 



그림 12-7. 본문이 창문에 적합하게 가까이 이동한 실례 
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그림 12-8. 본문이 창문을 채우기 위하여 더 멀러 이동한 실례 
ShowMetrics 머 리 부파일 

1 /* showmetrics.h */ 

2 #ifndef SHOWMETRICS_H 

3 #defme SHOWMETRICS_H 

4 

5 #include <qwidget.h> 

6 

7 class ShowMetrics: public QWidget 

8{ 

9 public: 

10 ShowMetrics(QWidget *parent=0,const char *name=0); 

11 protected: 

12 virtual void paintEvent(QPaintEvent *); 

13 }； 

14 

15 #endif 


ShowMetrics 

1 /* showmetrics.cpp */ 

2 #include <kapplication.h> 
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3 #include <qpainter.h> 

4 #include <qpaintdevicemetrics.h> 

5 #include "showmetrics.h" 


7 int main(int argc, char **argv) 

8 { 

9 KApplication app(argc, argv, "showmetrics"); 

10 ShowMetrics showmetrics; 

11 showmetrics. show(); 

12 app.setMainWidget(&showmetrics); 

13 return (app.exec()); 

14} 

15 ShowMetrics: :ShowMetrics(QWidget ^parent,const 

16 char *name) : QWidget(parent,name) 

17 { 

18 resize(400,300); 

19} 

20 void ShowMetrics :: paintEvent(QPaintEvent *) 

21 { 

22 QString str; 

23 QPaintDeviceMetrics metrics(this); 

24 QBrush bmsh(QColor("white")); 

25 int yincr = metrics.height() / 9; 

26 int y = yincr; 

27 intx= 10; 

28 

29 QPainter p(this); 

30 if((metrics.width() > 40) && (metrics.height() > 40)) { 

31 p.setPen(Qt: :NoPen); 

32 p. setBrush(brush); 

33 p.drawRect(20,20, 

34 metrics.width() - 40,metrics.height() - 40); 

35 p.setPen(Qt: :SolidLine); 

36 p.setBrush(Qt: : NoBrush); 


37 
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38 str.sprintf(’’%d width in pixels", 

39 metrics.width()); 

40 p.drawText(x,y,str); 

41 y += yincr; 

42 str.sprintf(’’%d height in pixels", 

43 metrics.height()); 

44 p.drawText(x,y,str); 

45 y += yincr; 

46 str.sprintf(’’%d width in millimeters", 

47 metrics.widthMM()); 

48 p.drawText(x,y,str); 

49 y += yincr; 

50 str.sprintf(’’%d height in millimeters”, 

51 metrics.heightMM()); 

52 p.drawText(x,y,str); 

53 y += yincr; 

54 str.sprintf( n %d X dots per inch", 

55 metrics.logicalDpiX()); 

56 p.drawText(x,y,str); 

57 y += yincr; 

58 str.sprintf("%d Y dots per inch", 

59 metrics.logicalDpiY ()); 

60 p.drawText(x,y,str); 

61 y += yincr; 

62 str.sprintf(’’%d total number of colors", 

63 metrics.numColorsO); 

64 p.drawText(x,y,str); 

65 y += yincr; 

66 str.sprintf("%d bits per pixel", 

67 metrics.depth()); 

68 p.drawText(x,y,str); 

69} 

20 행의 paintEvent() 메쏘드는 창문을 칠할 필요가 있을 때마다 호출된다 . 이것은 또한 창 
문이 처음으로 나타날 때，창문이 그 앞에 있던 창문을 제거하여 로출될 때 , 이 응용프로그 
람에서 가장 중요한 창문크기가 변화할 때마다 발생한다 . 
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QPaintDeviceMetrics 객체는 23 행에서 만들어지는데 그것은 도형을 비례에 따라 확대축소 
하는데 필요한 모든 정보를 가진다 . 여기에 2 개의 높이와 너비값들이 있다 . 하나는 화소수로 
측정되고 다른것은 mm 로 측정된다 . 단위설정은 칠해지는 장치의 특성에 따른다 . 실례로 인 
쇄 기 에 그림 을 그리 려한다면 mm 를 단위 로 리 용하는것 이 좋다 . 그러 나 현시 된 창문에 만들 
어진 그림들은 크기(심지어 갈은 화소분해능)에 따라 널러 변화할수 있으므로 화소측도를 
가지고 조작하는것이 제일 좋다 . 

25 〜 27 행은 현시하려는 첫 문자렬의 x 와 y 자리표들을 설정하고 창문 아래로 문자렬들 
사이 의 간격을 유지하기 위하여 y 값을 변경할 증분을 계산한다 . 8 개 문자렬을 현시하려 고 하 
므로 우와 아래를 계산하면 9 개의 수직간격이 있으며 창문의 전체 높이를 9 로 나누어 그들 
사이의 거리를 결정한다 . 

30 〜 37 행의 코드는 창문에 맞게 크기조절된 백색 직 4 각형을 그린다 . 직 4 각형은 창문의 
4 개의 모든 변들로부터 정확히 20 화소 떨어지도록 그러진다 . 30 행의 if 문은 직 4 각형을 그릴 
충분한 자리가 없으면 직 4 각형을 뛰여넘는다 . 직 4 각형륜곽을 제한하기 위하여 31 행의 
setPen () 호출은 현재 펜을 삭제한다 . 32 행의 setBmsh () 호출은 직 4 각형을 채울 흰솔을 설치하고 
33 행의 drawRect () 호출은 직 4 각형을 그린다 . 직 4 각형은 창문에 매 변으로부터 20 화소 떨어진 
곳에 만들어진다 . 35 행과 36 행은 기정펜을 되살리고 흰솔을 삭제한다 . 

38 〜 68 행은 창문에서 수값과 본문을 인쇄한다 . x 값을 변화시키지 않고 모든 문자렬이 
창문의 왼쪽변으로부터 같은 거리만큼 떨어져서 시작된다 . 매개 선이 그려진 후에 yincr 에 
보관된 값은 매개 문자렬이 전체 창문높이의 9 분의 1 로서 우의 문자렬아래에 나타나도록 하 
기 위하여 y 에 더해진다 . 


제7절. 화소그리기 

다음 프로그람은 살창을 만들고 그우에 씨누스곡선을 그려서 그림 12-9 와 같이 한번에 
한 화소 그리기를 진행한다 . 



그림 12-9. 한번에 한화소씩 그린 곡선과 살창 
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DrawPixel 머 리 부파일 

1 /* drawpixel.h */ 

2 #ifndef DRAWPIXEL 一 H 

3 #define DRAWPIXEL_H 

4 

5 #include <qwidget.h> 

6 

7 class DrawPixel: public QWidget 
8{ 

9 public: 

10 DrawPixel(QWidget *parent=0,const char *name=0); 

11 protected: 

12 virtual void paintEvent(QPaintEvent *); 

13 }； 

14 

15 #endif 
DrawPixel 

1 /* drawpixel.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include "drawpixel.h" 

5 

6 int main(int argc, char **argv) 

V{ 

8 KApplication app(argc, argv, "drawpixel"); 

9 DrawPixel drawpixel; 

10 drawpixel.show(); 

11 app.setMainWidget(&drawpixel); 

12 retum(app. exec()); 

13} 

14 DrawPixel: :DrawPixel(QWidget *parent,const 

15 char *name) : QWidget(parent,name) 

16 { 

17 setFixedSize(400,200); 


18 
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19 void DrawPixel :: paintEvent(QPaintEvent *) 

20 { 

21 QPainter p(this); 

22 p.setPen(QColor("white")); 

23 for(int x=20; x<400; x += 20) { 

24 for(int y=20; y<200; y += 20) { 

25 p.drawPoint(x-1 ,y); 

26 p.drawPoint(x+1 ,y); 

27 p.drawPoint(x,y-1); 

28 p.drawPoint(x,yH-l); 

29 } 

30 } 

31 p.setPen(QColor("red "))； 

32 for(double x=0; x<400; x++) { 

33 double y = sin(x / 30); 

34 y *= x / 4; 

35 y4= 100; 

36 p.drawPoint((int)x,(int)y); 

37 } 

38} 

19 행에서 시작하는 paintEvent() 메쏘드는 살창점들과 곡선을 그린다 . 여기서 점은 보통 
선을 그리는데 사용한 QPen 으로 그린다 . 화소는 가능한 모든 선들중에서 가장 짧은 선으로 
서 볼수 있다 . 22 행 은 setPen() 을 호출하여 점 들을 그리 기 위한 백 색 펜을 설정 하고 31 행 은 
setPen() 을 호출하여 곡선을 만드는 점 들을 그리 기 위한 적색 펜을 만든다 . 

23 〜 30 행의 순환은 그림 12-9 에 보여준 백색점들을 그린다 . 점들은 수직뿐아니라 수평 
으로도 모두 20 화소간격으로 그러진다 . 매개 점은 4 개 화소로서 그러진다 . 

32 〜 37 행에서 순환은 왼쪽에서 오른쪽으로 크기가 증가하는 씨누스파를 그린다 . 변수 x 
와 y 는 계산을 간단화하기 위하여 2 배로 선언한다 . 창문은 400 화소너비로 고정되므로 x 값은 
0 에서 400 까지 변화하고 400 개의 《화소렬》에 1 개의 색칠한 화소가 생긴다 . 33 행은 씨누스값 
을 계산한다 . 그리고 x 값을 라디안수로서 취급한다 . (30 이 아닌 나누는수를 사용하는것은 여 
기서 창문에 나타나는 주기수를 변경한다 ). 34 행에 의해 x 가 커질때 y 가 커진다 . 35 행은 y 값 
에 100 을 더하여 창문에서 수직으로 중심에 배치된다 . 36 행의 drawPoint() 호출은 화소를 칠한 
다 . 
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제 8 절. 화소배렬의 그리기 

앞의 실례에서는 창문을 칠할 때마다 매번 모든 점들을 계산하였다 . 보통 한번만 점들 
을 계산하거나 혹은 파일로부터 그것들을 적재하여 배렬에 보관하는것이 더 편리하다 . 다음 
실례는 그림 12-9 와 같은 창문을 현시하지만 한번만 화소위치들을 계산하여 배렬에 보관한 
다 . 

DrawPixel2 머 리 부파 일 

1 /* drawpixel2.h */ 

2 #ifndef DRAWPIXEL 一 H 

3 #define DRAWPIXEL_H 

4 

5 #include <qwidget.h> 

6 #include <qpointarray.h> 

7 

8 class DrawPixel2: public QWidget 
9{ 

10 public: 

11 DrawPixel2(QWidget *parent=0,const char *name=0); 

12 private: 

13 QPointArray *grid; 

14 QPointArray *curve; 

15 protected: 

16 virtual void paintEvent(QPaintEvent *); 

17 }； 

18 

19 #endif 

13 행과 14 행은 한쌍의 QPointArray 객체에로의 지적자들을 선언 한다 . curves 는 궤도를 점 
들로 그리는데 사용되며 grid 는 배경에서 흰점의 위치들에 살창을 그리는데 리용된다 . 
DrawPixel2 

1 /* drawpixel2.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include "drawpixel2 上 " 




V{ 

8 KApplication app(argc, argv, "drawpixel2 M ); 

9 DrawPixel2 drawpixel2; 

10 drawpixel2. show(); 

11 app.setMainWidget(&drawpixel2); 

12 return (app.exec()); 

13} 

14 DrawPixel2: :DrawPixel2(QWidget *parent,const 

15 char *name) : QWidget(parent,name) 

16 { 

17 int index; 

18 setFixedSize(400,200); 

19 

20 grid = new QPointArray(4 * 20 * 10); 

21 index = 0; 

22 for(int x=20; x<400; x += 20) { 

23 for(int y=20; y<200; y += 20) { 

24 grid->setPoint(index++,x-1 ,y); 

25 grid->setPoint(index+H-,x+1 ,y) ； 

26 grid->setPoint(index++,x,y-1); 

27 grid- 〉 setPoint(index++,x,y+1); 

28 } 

29 } 

30 curve = new QPointArray(400); 

31 index = 0; 

32 for(double x=0; x<400; x++) { 

33 double y = sin(x / 30); 

34 y *=x/4; 

35 y+= 100; 

36 curve->setPoint(indexH-+,(int)x,(int)y); 

37 } 

38} 

39 void DrawPixel2 :: paintEvent(QPaintEvent *) 

40 { 

41 QPainter p(this); 
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42 p.setPen(QColor("white")); 

43 p.drawPoints(*grid); 

44 p.setPen(QColor( n red M ))； 

45 p.drawPoints(*curve); 

46} 

14 행에서 시작하는 구성자는 계산을 수행하고 배럴들에 그 결과를 보관한다 . 18 행의 
setFixedSize () 호출은 창문이 크기 가 변경 되 는것을 금지 한다 . 

살창점을 가지기 위한 QPointArray 객체는 20 행에서 만들어진다 . 배렬에는 매개 점에 대 
하여 한개 항목이 있으므로 배렬의 총 크기는 4 ( 매개 살창점에서 화소수 :) ， 20(x 축을 따라 나 
타나는 살창점의 수 :), 그리고 10(y 축을 따라 나타나는 살창점의 수)의 적이다 . 22 〜 29 행의 순 
환은 매 개 살창점 들에 4 화소위치 를 삽입한다 . 

곡선 궤 도를 포함하기 위 한 QPointArray 객 체 는 30 행 에 서 만들어 진 다 . 계 산과 점 의 개 수 
는 앞의 실례와 같다 . 400 개의 점을 계산하였으므로 이것들은 36 행의 setPoint () 호출에 의해 
배렬에 보관된다 . 

39 행에서 시작되는 paintEvent () 메 쏘드는 앞의 실례 보다 훨씬 적게 실행 한다 . QPainter 객 
체가 만들어지고 백색펜은 살창의 점들을 그리는데 사용되며 적색펜은 곡선의 점들을 그리 
는데 사용된다 . 

일부 경우에 값들을 다시 계산할 필요가 있으나 그럴 필요가 없는 경우도 있다 . 실례로 
창문크기가 변할 때 값들을 다시 계산하려고 한다면 paintEvent () 메 쏘드의 제일 웃부분에서 
QPaintDeviceMetrics 의 값들을 사용하여 창문크기가 변화하였는가를 결정하고 만일 그렇다면 
계산을 수행하는 메쏘드를 호출한다 . 

제9절. 백토르직선그리기 

2 개의 메쏘드를 벡토르그리기에 사용할수 있다 . 그러나 drawLineO 으로 모든 그리기를 
할수 있으므로 일정한 종류의 그림 을 그리 는데 매우 편리하다 . 메쏘드 moveTo 分와 lineToO 는 
도형처 리가 펜작도기 에서 리용되 던 방법 이 그대로 적용된 메쏘드이 다 . 이 두 메쏘드는 한곳 
에서 다른 곳으로 펜을 이동하시켜 직선을 그리지만 그것들중 하나는 펜을 눌러서 직선을 
그린다 . 펜은 항상 위치를 가지므로 직선을 그리기 위하여서는 직선의 다른 끝을 지정하는 
것만이 필요하며 일단 직선을 그렀으면 펜은 다시 새로운 위치를 지정하여야 한다 . 

다음 실례는 파일로부터 그리기지령을 읽어들이고 그것을 리용하여 그림 12-10 에 보여 
준 도형 을 현시한다 . 입 력 본문파일의 매개 직 선은 연산코드(이동은 m, 그리 기 는 句와 사건 이 
발생하는 자리표점위치를 가전다 . 이 실례에서 사용된 파일은 다음과 같은 파라메터를 가지 
고 시작된다 . 

m60 110 


d60 10 


295 



d 160 10 
d 160 60 
m 160 80 
d 160 180 

첫째 명령은 점 (60,110 ) 으로 이동하는 지령이다 . 둘째 명령은 펜의 위치 (60,110 ) 로부터 
새 위치 (60,10 ) 까지 직선을 그린다 . 



그림 12-10. 파일에 정의된 직선그리기 

1 /* drawvector.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include <stdio.h> 

5 #include ’’drawvector.h” 

6 

7 int main(int argc, char **argv) 

8 { 

9 KApplication app(argc, argv, "drawvector"); 

10 DrawV ector drawvector; 

11 drawvector. show(); 

12 app. setMainWidget(&drawvector); 

13 return (app.exec()); 

14} 

15 DrawVector: : DrawVector(QWidget ^parent,const 

16 char *name) : QWidget(parent,name) 
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18 setFixedSize(230,190); 

19} 

20 void DrawVector::paintEvent(QPaintEvent *) 

21 { 

22 FILE *fd; 

23 char code [20]; 

24 int x; 

25 int y; 

26 

27 if((fd = fopen( ,, points.dat ,, ? , V f )) != NULL) { 

28 QPainter p(this); 

29 while(fscanf(fd, ”%s %d %d M ,code,&x,&y) == 3) { 

30 if(code[0] == ， m，) 

31 p.moveTo(x,y); 

32 else if(code[0] == ’d’) 

33 p.lineTo(x,y); 

34 } 

35 fclose(fd); 

36 } 

37} 

모든 그리기는 28 〜 34 행의 순환에서 수행된다 . 28 행은 QPainter 객체를 만들어서 도형그 
리기조작을 초기화한다 . 29 행의 fscanf() 호출은 한행의 입력자료 즉 명령， x 자리표， y 자리표 
를 읽어들인다 . 명령이 현재 유표를 이동시키는것이라면 메쏘드 moveToO 는 31 행에서 호출 
된다 . 명령이 현재 유표위치로부터 새로운 위치까지 직선을 그리는것이라면 33 행에서 
lineTo() 호출이 이루어진다 . 


제10절. 선분과 다각형 

몇가지 QPainter 메쏘드들은 QPointArray 객체에 점 모임을 보관하고 그다음 점들을 리 용하 
여 다각형을 그린다 . 다음 프로그람은 선분모임을 그리는 방법들중 일부를 보여준다 . 

1 /* drawpoly.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include "drawpoly.h" 


6 int main(int argc, char **argv) 
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V{ 

8 KApplication app(argc, argv, "drawpoly"); 

9 DrawPoly drawpoly; 

10 drawpoly.show(); 

11 app.setMainWidget(&drawpoly); 

12 return (app.exec()); 

13} 

14 DrawPoly: : DrawPoly(QWidget *parent,const 

15 char *name) : QWidget(parent,name) 

16 { 

17 setFixedSize(500,100); 

18} 

19 void DrawPoly: :paintEvent(QPaintEvent *) 

20 { 

21 int offset = 0; 

22 QPointArray parray(lO); 

23 QPainter p(this); 

24 

25 setPoints(parray,offset); 

26 p. drawLine Segment s(parray); 

27 

28 setPoints(parray,offset += 100); 

29 p.drawPolyline(parray); 

30 

31 setPoints(parray,offset += 100); 

32 p.drawPolygon(parray); 

33 

34 p.setBrush(QColor("white M )); 

35 setPoints(parray,offset += 100); 

36 p.drawPolygon(parray,TRUE); 

37 

38 setPoints(parray,offset += 100); 

39 p.drawPolygon(parray,FALSE); 

40} 

41 void DrawPoly::setPoints(QPointArray &parray,int offset) 
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42 { 

43 parray.setPoint(0,10+offset,50); 

44 parray.setPoint( 1,70+offset,50); 

45 parray.setPoint(2,70+offset,30); 

46 parray.setPoint(3,50+offset,30); 

47 parray.setPoint(4,50+offset,90); 

48 parray.setPoint(5,30+offset,90); 

49 parray.setPoint(6,30+offset,10); 

50 parray.setPoint(7,90+offset, 10); 

51 parray.setPoint(8,90+offset,70); 

52 parray.setPoint(9,10+offset,70); 

53} 

41 행의 setPoints () 메쏘드는 배렬에 점들을 삽입한다 . 이 점모임은 그림 12-11 과 같이 매 
그리기에 사용되지만 이때 례외로 수평위치가 변위계산의 량만큼 오른쪽으로 이동한다 . 



그림 12-11. 여러가지 형래의 다각형그리기 

26 행의 drawLineSegmentsO 호출은 그림 12-11 의 첫번째 다각형을 그린다 . 이때 오직 선 
분만 그리므로 그것들이 결합되지 않는다 . 즉 첫째 선분은 point [이과 point[l ] 사이에서 그려 
지며 둘째는 point[2 ] 과 point[3 ] 사이에서 그러진다 . 선분을 이루는 점들은 점들의 배렬에서 2 
개의 성분이 여야 한다 . 물론 선분의 끝점을 다음 선분의 출발점으로 사용하여 선분들을 이 
어 다각형을 만들수도 있다 . 

32 행의 drawPolyLine () 호출은 drawLineSegmentsO 와 같은 입력정보를 사용하지만 그것은 
앞의 선분이 끝난 점에서부터 새로운 선분을 시작함으로써 모든 선분들이 련결된 다각형을 
그린다 . 즉 첫째 선분은 point [이과 point[l], 들째 선분은 point[l ] 과 point[2], …으로 그러진다 . 
그런데 점배럴에서 마지막 점과 첫 점이 일치하지 않으므로 다각형은 닫기지 않는다 . 

32 행의 dmwPolygon () 호출은 drawLineSgemetns () 와 같은 방법으로 도형을 그리지만 끝점 
으로부터 시작점까지 반대로 선분을 그리므로 닫긴 도형을 만든다 . 

36 행의 drawPolygon () 호출은 QBrush 가 QPainter 객체에 보관된 후에 다각형을 그리며 그 
결과다각형을 색칠한다 . 다른 어떤 도형에서나 구역의 륜곽선을 그리기전에 구역을 색칠하 
므로 륜곽선이 색칠한 구역우에 나타나게 된다 . 메쏘드호출의 둘째 인수는 겹침부분색칠규 
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칙을 TRUE 로 설정하는데 이것은 다각형의 모든 구역들이 겹침에 관계없이 채워진다는것을 
의미 한다. 

39 행의 drawPolygon() 호출은 앞의것과 동일하지만 겹 침 부분색 칠규칙 은 FALSE 로 설정 된 
다. 이 설정은 도색되는 다각형의 령역들서 한 령역이 다른 령역에 가리워진다. 그러므로 그 
림 12-11 에서 제일 오른쪽 그림에서 도형의 겹침구역은 색칠되지 않는다는것을 보여준다. 즉 
겹침점 에는 두 층의 도형 이 있다. 만일 도형 이 3 개 층으로 되 여있으면 다시 색칠된다. 

제11절. 타원과 원 

원은 높이와 너비가 같은 타원이므로 메쏘드 drawEllipseO 는 원과 타원을 그리는데 사 
용된다. 다음 프로그람은 그림 12-12 와 같이 2개 타원과 한개 원을 가진 창문을 현시한다. 

1 /* drawellipse.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include "drawellipse.h" 

5 

6 int main(int argc, char **argv) 

7{ 

8 KApplication app(argc, argv, "drawellipse"); 

9 DrawEllipse drawellipse; 

10 drawellipse. show(); 

11 app. setMainWidget(&drawellipse); 

12 return (app.exec()); 

13} 

14 DrawEllipse :: DrawEllipse(QWidget ^parent,const 

15 char *name) : QWidget(parent,name) 

16 { 

17 setFixedSize(260,140); 

18} 

19 void DrawEllipse :: paintEvent(QPaintEvent *) 

20 { 

21 QPainter p(this); 

22 


23 p.drawEllipse(10,50,l 10,40); 

24 p.setBrush(QColor("white M )); 
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25 p.drawEllipse(l 30,25,90,90); 

26 p.setPen(NoPen); 

27 p.drawEllipse(230,10,20,120); 
28} 



그림 12-12. 2 개 타원과 한개 원 

drawEllipseO 메쏘드는 타원의 4 개 측면을 지정하기 위하여 경계직 4 각형을 정의할것을 
요구한다 . 경계직 4 각형은 그 왼쪽웃구석의 x 와 y 자리표 , 그리고 직 4 각형의 너비와 높이에 의 
해 정의된다 . 실례로 그림 12-12 의 왼쪽에 있는 타원은 23 행의 drawEllipseO 호출에 의해 그려 
지며 왼쪽웃구석은 왼변으로부터 10 화소 , 우로부터 50 화소에 있다 . 타원의 너비는 110 화소이 
고 높이는 40 화소이다 . 

QBrush 객 체 는 24 행 의 sefflrushO 호출에 의 해 QPainter 에 추가되 므로 나머 지 타원들은 솔 
색으로 칠해진다 . 26 행은 setPenO 을 호출하여 QPainter 로부터 펜을 삭제하므로 오른쪽 타원은 
륜곽선을 가지지 않는다 . 

왼쪽웃구석대신에 중심점주위에 원이나 타원을 그릴 필요가 있다 . 그러기 위해서는 간 
단히 중심 점으로부터 매개 방향으로 반경 을 덜 어서 왼쪽웃구석 의 위치 를 지 정한다 . 
p.drawEllipse(x - (w / 2%y - (h / 2),w,h); 

제 12 절. 원과 타원의 부분그리기 

원이나 타원의 일부분만을 그리는 방법이 3 가지 있다 . 그 과정은 앞의 실례와 같이 원 
또는 타원을 그러는것과 갈지만 시작각도와 마감각도를 지정해 야 한다 . 

각도는 도의 16 분의 1 단위로 계산된다 . 고정코드의 각도를 입력하려고 하는 경우에 일 
반적 으로 사용하는 각도에 대 하여 표 12-2 에 제시한다 . 

표 12-2. 각도계산단위들의 비교 
Qt 단위一 i rad 











Qt 단위 

도 

rad 

2160 

135 

2.3562 

2880 

180 

3.1416 

3600 

225 

3.9270 

4320 

270 

4.7124 

5040 

315 

5.4978 

5760 

360 

6.2832 


각도를 계산하려고 한다면 대부분의 수학프로그람들은 도 또는 라디안을 사용하므로 
그것들을 변환하여 야 한다 . 다음 명 령문은 도와 라디 안을 Qt 비률로 변환한다 . 
angle = degree * 16; 
angle = (radian * 180) / PI; 

반대로 Qt 비률을 도와 라디안으로 변환하기 위해서는 다음의 명령문을 리용한다 . 
degree = angle /16; 
radian = (angle * PI) / 180 ； 

각도의 정방향회전은 시계바늘과 반대방향이다 . 0 ᄋ점은 오른쪽으로 한다 . 시작각도는 그 
리기가 시작하는 0 점으로부터 거리를 지정하며 마감각도는 시작각도로부터 그리기의 끝까지 
거 리를 지 정한다 . 두 수값은 정수 혹은 부수가 될수 있다 . 시 작각도가 마감각도보다 크면 그 
리기는 정방향(시계바늘과 반대방향)으로 진행되며 시작각도가 마감각도보다 작으면 그리기 
는 역방향 ( 시계바늘방향)으로 진행된다 . 

다음 실례는 호를 그리는 3 가지 수법 을 설명한다 . 

1 /* arcpiechord.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include "arcpiechord.h" 

5 

6 int main(int argc, char **argv) 

7{ 

8 KApplication app(argc, argv, ’’arcpiechord"); 

9 ArcPieChord arcpiechord; 

10 arcpiechord. show(); 

11 app.setMainWidget(&arcpiechord); 

12 return (app.exec()); 

13} 

14 ArcPieChord: : ArcPieChord(QWidget ^parent,const 

15 char *name) : QWidget(parent,name) 
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16 { 

17 setFixedSize(260,420); 

18} 

19 void ArcPieChord::paintEvent(QPaintEvent *) 

20 { 

21 QPainter p(this); 

22 

23 p.drawArc(10,50,110,40,0,4000); 

24 p.drawChord(10,190，l 10,40,0,4000); 

25 p.drawPie(10,330,110,40,0,4000); 

26 p.setBrush(QColor( M white M )); 

27 p.drawArc(130,25,90,90,0,2000); 

28 p.drawChord(130,165,90,90,0,2000); 

29 p.drawPie(l 30,305,90,90,0,2000); 

30 p.setPen(NoPen); 

31 p.drawArc(230,10,20,120,720,4320); 

32 p.drawChord(230,150,20,120,720,4320); 

33 p.drawPie(230,290,20,120,720,4320); 

34} 

23 행의 drawArcO 호출은 그림 12-13 의 왼쪽웃구석에 도형을 만든다 . 이 도형은 훅색펜과 
솔이 없는 기정 QPainter 를 사용하여 그려지는데 타원과 같은 경계직 4 각형수법을 리용한다 . 
즉 타원의 일 부분만 그리 지 만 전 체 타원의 경 계 직 4 각형 의 왼 쪽웃구석 의 x 와 y 를 선 택한다 . 
시작각도는 0, 마감각도는 약 270 도인 4000 이다 . 





27 행의 drawArcO 호출은 그림 12-13 의 첫행의 중심에 도형을 그린다 . 이 도형은 솔을 가 
지고있는 QPainter 에 의해 그려지지만 호가 닫긴 도형이 아니므로 색칠되지 않는다 . 31 행의 
drawArcO 호출은 펜이 금지되였고 drawArcO 가 솔을 사용하지 않으므로 나타나지 않는다 . 

24 행 의 drawChord () 호출은 그림 12-13 의 중심행 의 제 일 왼쪽에 그린 다 . 현은 호의 끝점 
들사이에 직선을 그어서 닫긴 도형을 만드는것을 제외하면 호와 같다 . 현이 닫긴 도형이므 
로 28 행과 32 행의 drawChord () 호출은 둘다 닫긴 구역을 솔색으로 칠한다 . 

25 행의 drawPieO 호출은 그림 12-13 의 바닥행의 제일 왼쪽 도형을 그린다 . 부채형은 중심과 2 
개 끝점사이에 2 개 직선을 그어서 닫긴 도형을 만드는것외에는 호와 갈다 . 부처형은 닫긴 도형이 
므로 29 행과 33 행의 drawPieO 호출은 모두 닫긴 구역을 솔색으로 칠한다 . 

제13절. 환4각형 

QPainter 의 메쏘드 drawRoundRect () 는 환 4 각형을 그러는데 사용된다 . 다음 실례는 바른 4 각형 , 
직 4 각형 , 원 , 그리고 타원과 함께 환 4 각형을 그리는데 사용할수 있는 drawRoundRectO 의 유연성을 
보여준다 . 프로그람은 그림 12-14 와 같이 많은 도형을 그린다 . 

1 /* roundrectangle.cpp */ 
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2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include ’’roundrectangle.h" 

5 

6 int main(int argc, char **argv) 

7{ 

8 KApplication app(argc, argv, "roundrectangle"); 

9 RoundRectangle roundrectangle; 

10 roundrectangle. show(); 

11 app.setMainWidget(&roundrectangle); 

12 return (app.exec()); 

13} 

14 RoundRectangle :: RoundRectangle(QWidget *parent,const 

15 char *name) : QWidget(parent,name) 

16 { 

17 setFixedSize(190,370); 

18} 

19 void RoundRectangle::paintEvent(QPaintEvent *) 

20 { 

21 QPainter p(this); 

22 p.setBrush(QColor("white M )); 

23 

24 p.drawRoundRect(l 0,10,50,50); 

25 p.drawText(30,35, "1"); 

26 

27 p.drawRoundRect(70,10,50,50,50,50); 

28 p.drawText(90,35, ”2"); 

29 

30 p.drawRoundRect(130,10,50,50,100,100); 

31 p.drawText(150,35, "3"); 

32 

33 p.drawRoundRect(10,70,170,50); 

34 p.drawText(90,95, "4"); 

35 


36 p.drawRoundRect(10,130,170,50,0,50); 




37 p.drawText(90,155, ， ’ 5"); 

38 

39 p.drawRoundRect(10,190,170,50,50,80); 

40 p.drawText(90,215, ”6"); 

41 

42 p.drawRoundRect(10,250,170,50,100,100); 

43 p.drawText(90,275, M 7 M )； 

44 


45 p.drawRoundRect(10,310,170,50,9,30); 

46 p.drawText(90,335, ”8"); 



그림 12-14. 여러가지 형식의 환 4 각형들 
다음 2 가지 메쏘드들중 하나를 호출하여 환 4 각형들을 그린다 . 


drawRoundRect(int x,int y,int w,int h) 


drawRoundRect(int x,int y,int w,int h, int xround,int yround) 

처음 4 개 인수는 직 4 각형을 정의한다 . 마지막 2 개 인수(둘다 기정값 25) 는 수직과 및 
수평 방향에서 모서리 들의 반경 을 지 정한다 . 

그림 12-14 에서 직 4 각형 1 은 24 행의 drawRoundeRectO 호출에 의 해 얻어진다 . 처 음 2 개 














인수는 직4각형 의 모서 리 가 원형 으로 되 지 않은 경 우의 왼쪽웃구석의 x 와 y 위 치 를 지 정한다. 
도형은 한 변이 50화소인 바른4각형이고 모서리들의 반경은 표와 y 방향으로 둘다 기정으로 
25로 설정된다. 이것은 수직거리의 25%와 수평거리의 25%는 원형모서리들을 만드는데 사용 
된 다는것 을 의 미한다. 

직4각형 2는 27행의 drawRoundedRect () 호출에 의해 얻어 진다. 직4각형 1처 럼 이 호출도 
바른4각형 을 생성 하지 만 수평 과 수직반경 들은 각각 기 정 으로 25%로 설정 되 지 않고 50%로 
설정 되였다. 

직4각형 3은 높이와 너비를 갈은 값으로 설정하고 모서리의 반경을 100%로 설정하면 
결과가 원으로 된다는것을 보여준다. 

직 4각형 4는 33행 에 서 그러 진 다. 수직 과 수평반경 은 기 정 으로 25%로 허 용되 지 만 직 4각 
형이 높이에 비하여 너비가 더 넓으므로 보다 수평방향에 수직방향보다 더 많은 화소들이 
포함되며 대칭이 아닌 곡선이 그러진다. 

36행에서 그려지는 직4각형5는 모서리의 반경중 하나 혹은 둘을 0%로 설정하면 바른4 
각형의 모서리로 된다는것을 보여준다. 이 실례에서 모서리의 수직반경은 50%로 설정되였으 
나 수평반경 이 0%이 므로 모서 리 가 곡선 이 될 수 없 다. 

39행에서 만들어지는 직4각형 6은 모서리의 수직반경 100%，수평반경 30%로 설정된다. 

42행 에서 그리 는 직4각형 7은 모서 리 의 수직 과 수평반경 이 모두 100%로 설정 되였으므 
로 결과는 타원이다. 

45행에서 그리는 직4각형 8은 모서리가 대칭반경을 가지도록 설계된다. 즉 수직과 수평 
방향 모두의 곡선에 같은 화소수가 포함된다. 모서리의 반경들이 퍼센트로 표시되므로 화소 
값을 선택한 다음 그것을 리용하여 매개 방향에서 퍼센트를 결정하여야 한다. 
xround = (100 * pixels ) / height ; 
yround = (100 * pixels ) / width ; 

제 14 절. 픽스매프와 본문의 그리기 

픽스매프의 전부 또는 일부분을 그릴수 있으며 본문을 그리는데 사용할 서체를 정의할 
수 있다. 다음 실례는 그림 12-15 와 같이 전체 픽스매프를 그리고 그 다음에 픽스매프의 부 
분을 그리며 다음으로 그림의 우에 본문을 쓴다. 




그림 12-15. 본문을 가지는 픽스매프 

DrawPixmap 머 리 부파일 

1 /* drawpixmap.h */ 

2 #ifndef DRAWPIXMAP_H 

3 #define DRAWPIXMAP_H 

4 

5 #include <qwidget.h> 

6 

7 class DrawPixmap: public QWidget 

8 { 

9 public: 

10 DrawPixmap(QWidget *parent=0,const char *name=0); 

11 private: 

12 QPixmap logo; 

13 protected: 

14 virtual void paintEvent(QPaintEvent *); 

15 }； 

16 


17 #endif 
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그리려는 QPixmap 는 자료로부터 오직 한번 만들어진다 . 그것은 12 행에서 줄임화상으로 
서 보관되므로 후에 현시에 사용할수 있다 . 

DrawPixmap 

1 /* drawpixmap.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include <qfont.h> 

5 #include ’’drawpixmap.h" 

6 

7 #include n logo.xpm" 

8 

9 int main(int argc, char **argv) 

10 { 

11 KApplication app(argc, argv, "drawpixmap"); 

12 DrawPixmap drawpixmap; 

13 drawpixmap.show(); 

14 app. setMainW idget(&drawpixmap); 

15 return (app.exec()); 

16} 

17 DrawPixmap::DrawPixmap(QWidget *parent,const 

18 char *name) : QWidget(parent,name) 

19 { 

20 logo = QPixmap(magick); 

21 setFixedSize(360,330); 

22 } 

23 void DrawPixmap :: paintEvent(QPaintEvent *) 

24 { 

25 QPainter p(this); 

26 

27 p.drawPixmap( 10,10,logo); 

28 p.drawPixmap(250,80,logo,50,50,1 00, 100); 

29 

30 QFont font = p.font(); 

31 font. setPoint Size( 18); 

32 p.setFont(font); 
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33 

34 p.setPen(QColor("white"))； 

35 p . drawText (200,250, " Penguin "); 

36} 

17 행 에서 시 작하는 구성 자는 7행 에서 포함된 자료파일 logo . xpm 로부터 줄임화상픽 스매 
프를 만든다. 그다음에 고정 크기 로 현시창문을 설 정한다. 

27 행의 drawPixmapO 호출은 전체 줄임화상픽스매프를 그린다. 픽스매프의 왼쪽웃구석은 
창문부품들의 왼 쪽면 으로부터 10화소，우에 서 부터 10화소 떨 어 진곳에 위 치한다. 다른 인수는 
지정되지 않았으므로 전체 픽스매프는 목표위치에 복사된다. 

28행의 drawPixmapO 호출은 줄임화상픽스매프의 한부분만 그린다. 이 메쏘드는 우선 픽 
스매프로부터 직4각형구역을 읽은 다음 목표창문에 그것을 그린다. 마지막 4개 메쏘드인수 
들은 왼쪽웃구석과 높이와 너비를 지정하고 도형을 배치할 구역을 결정한다. 배치하려는 구 
역은 픽스매프의 왼쪽으로부터 60화소，우로부터 50화소이며 그 너비는 100화소, 높이는 80 
화소이다. 처음 2개 인수는 픽스매프를 그리려는 곳을 지정하며 그 왼쪽웃구석은 왼쪽에서 
250화소, 우로부터 80화소에 배치된다. 

모든 QPainter 객체는 본문을 그리는데 사용하는 QFont 객체를 포함한다. 기정서체를 사용 
하거 나 새로운 서 체를 만들기 또는 이 실례처 럼 현존서 체 를 수정할수 있다. 30행의 font 。 호 
출은 QPainter 객체로부터 QFont 객체를 엄는다. 이 실례에서 31행의 setPointSizeO 호출은 본문 
을 좀 크게 만든다. setFont () 호출은 QPainter 본문을 모두 그리는데 사용되는 새로운 서체를 
설 정 한다. 

34행의 setPen () 호출은 본문이 기정의 흑색대신 백색으로 나타나게 하고 35행의 
drawTextO 호출은 창문의 왼쪽으로부터 200화소，우로부터 250화소되는 위치에 본문을 그린다. 

요 약 

이 장에서 설명 한 QPainter 메쏘드들은 언제 나 요구되는 도형처 리의 90%이상 제공한다. 
도형그리는 2개의 객체 QPen 과 QBrnsh 만을 리용하여 모든 도형을 그릴수 있다. 특수한 경우 
에 필요한것을 정확히 얻기 위하여 화소별수법을 사용할수 있다. 

이 장은 다음과 같은 그리기를 하는데 사용할수 있는 QPainter 메쏘드들을 설명하였다. 

• 창문에 한번에 한 화소 그리거나 혹은 화소배렬을 보관할 객체들을 정의하고 그것들 
을 한번에 그린다. 

• 한 점에서 다른 점까지 여러색과 여러 크기로 직선을 그린다. 또한 여러 선분을 한번 
에 하나씩 또는 모두 그릴수 있다. 

• 타원과 원을 모두 그리 거 나 그것들의 일부분만을 그릴수 있다. 각이한 형 식 으로 원과 
타원들을 색칠하고 잘라낼수 있다. 

• 픽스매프들을 전부 그리거나 직 4 각형구역을 선택하여 그린다. 
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제 13 장. 도형에 대한 조작 

학습내용 

도형조작명령렬의 보관 및 현시기에 재생하기 
창문과 다른 도형들의 인쇄 
인쇄기의 도형그리기능력의 질문 

도형의 비례확대축소，오려내기，경사지기，회전 및 변환 
그려낸 도형과 화상의 렬로 동화만들기 
비트준위에서 화소색들의 조작 

앞 장은 창문에 도형을 그리고 색칠하는 기초를 설명하였으나 이 장은 KDE 와 (건에서 
도형 조작을 위한 특별 한 몇 가지 기 능들을 설 명한다. 

이 장에서 설명한 대부분의 기 술은 도형 의 내 용을 변경 하는데 사용될수 있다. 아마도 
가장 유용한 정보에는 화상들의 회전, 배치를 합리적으로 진행하기 위한 내용들이 더 많이 
포함되 여 야 한다. 색 또는 흑백색으로 도형화상을 인쇄하는것은 매우 간단한 과정 이다. 그러 
나 도형 을 비 례 확대 축소하고 경 사지 게 하여 모양을 변 경할수 있으며 지 어 매 화소의 비 트값 
들을 변경하여 수정할수 있고 동화는 한개 프레임씩 그리고 시간조종렬로 프레임들을 현시 
할수 있다. 


제1절. QPicture 에 의한 도형의 보관 

창문부품의 창문에 그릴수 있는것은 QPicture 객체에 그릴수 있다. QPicture 객체는 디스크 
파일에 그리기명령을 보관할수 있고 다른 QPicture 객체는 파일을 읽어들이고 그 그리기지령 
을 실행할수 있다. 복잡한 그림을 보관하고 한 체계에서 다른 체계에로 도형을 전송하는것 
을 비롯하여 도형을 리용하는 목적은 많다. 다음 프로그람은 간단한 그림을 만들고 디스크 
파일에 보관한다. 

Record 

1 /* record.cpp */ 

2 #include < iostream . h > 

3 #include < kapplication . h > 

4 #include < qpainter . h > 

5 #include < qpicture . h > 

6 #include < qwidget . h > 

7 

8 int main(int argc,char ** argv ) 

9{ 

10 KApplication app ( argc , argv , " record "); 
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11 QPainter paint ; 

12 QPicture pic ; 

13 

14 paint . begin (& pic ); 

15 paint . setBrush ( QColor ( n black ")); 

16 paint . drawRect (50,75,3 50, 100); 

17 paint . setBrush ( QColor (" white n )); 

18 paint . drawEllipse(l 50,50,1 50, 150); 

19 paint . setPen ( QWidget : : NoPen ); 

20 paint . drawRect ( 1 00, 100,250,50); 

21 paint . end (); 

22 if (! pic . save (" recplay . qpic M )) 

23 cout « ’’Unable to create recplay . qpic ” « endl ; 

24} 

이 프로그람은 도형을 만들지만 창문을 현시하지 않는다. 대신에 그림에서 QPicture 객체 
를 리용하며 QPicture 객체는 모든 지령을 기록한 다음 디스크파일에 써넣는다. 

10행에서 KApplication 객체 app 는 QPainter 객체가 오직 KDE 응용프로그람에서 만 사용될 
수 있으므로 KDE 응용프로그람에서처 럼 이 것을 정 의한다. 11행과 12행은 그리 기 에서 사용되 
는 QPainter 객체와 QPainter 지령을 기록하는 QPicture 객체를 만든다. 

14행은 begin () 을 호출함으로써 도형 그리 기 를 위한 대화를 시 작한다. 그리 기 객체는 창문 
부품이 아니라 QPicture 객체이다. 15〜20행은 QPainter 펜과 솔값을 설정하고 실제로 메쏘드를 
호출하여 그린다. QPicture 객체는 매 메쏘드호출들을 보존한다. 그리기대화는 21행의 endO 호 
출에 의해 정지된다. 22행의 save () 호출은 recplay 라는 파일을 만든다. qpic 는 모든 그리기명령 
들을 가지고있다. 

Playback 머 리 부파 일 

1 /* playbacks */ 

2 # i&def PLAYBACK_H 

3 #define PLAYBACK H 


5 ^include < qwidget . h > 

6 

7 class Playback : public QWidget 

8 { 

9 public : 

10 Playback(QWidget * parent =0 ,const char * name =0); 



11 protected: 

12 virtual void paintEvent(QPaintEvent *); 

13 }； 

14 

15 #endif 
Playback 

1 /* playbackxpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include <qpicture.h> 

5 #include ’’playback.h’’ 

6 

7 int main(int argc’char **argv) 

8{ 

9 KApplication app(argc,argv, "playback"); 

10 Playback playback; 

11 playback. show(); 

12 app.setMainWidget(&playback); 

13 return (app.exec()); 

14} 

15 Playback: : Playback(QWidget *parent,const 

16 char *name) : QWidget(parent,name) 

17 { 

18 setFixedSize(450,250); 

19} 

20 void Playback: : paintEvent(QPaintEvent *) 

21 { 

22 QPainter p(this); 

23 QPicture picture; 

24 

25 if(picture.load("recplay.qpic")) 

26 p.drawPicture(picture); 

27} 

20 행의 paintEvent() 메쏘드는 보관된 명령을 얻기 위해 QPicture 객체를 만든다 . 25 행의 
load() 호출은 명령목록을 얻고 load() 호출이 성공하면 26 행의 drawPictureQ 호출은 파일에 보관 




된 모든 명령을 실행한다 . 결과는 그림 13-1 에 보여준 창문이다 . 




그림 13-1. 이 전에 보관한 도형 그리 기명 령의 재생 
이미 보관된 도형그리기명령들의 재생은 QPainter 객체를 사용하므로 프로그람이 보관된 
명령들을 리용하는데서 문제가 발생하지 않는다 . 실례로 그림 13-2 에 보여주는 화상은 
paintEventO 메쏘드의 paint 명 령 들을 다음과 같이 변경한 결과이 다 . 
if(picture.load("recplay.qpic")) 
p.drawPicture(picture); 
p.setBrush(QColor("black")); 
p.drawRect(l 10,110,230,30); 



그림 13-2. 재생과 현재 도형명령의 결합 






제 2 절. 인쇄기에 도형의 그리기 

인쇄기에 대한 화면인쇄는 현시기에 창문을 그리는것처럼 간단하다 . 다음 실례프로그람 
은 이전에 그림 13-1 에 보여준것과 같은 도형창문을 현시한다 . 다른것은 오른쪽아래구석에 
Print 단추를 추가한것이다 . 단추선택은 그림 13-3 에 보여준 대화칸을 펼치면 인쇄에 대한 설 
정을 할수 있다 . 사용자가 0K 단추를 찰칵하면 도형이 인쇄된다 . 

PrintGraphic 머 리 부파일 

1 /* printgraphic.h */ 

2 #ifndef PRINTGRAPHIC_H 

3 #define PRINTGRAPHIC_H 

4 

5 #include <qwidget.h> 

6 #include <qpushbutton.h> 

7 

8 class PrintGraphic: public QWidget 

9{ 

10 Q_OBJECT 

11 public: 

12 PrintGraphic(QWidget *parent=0,const char *name=0); 

13 private: 

14 QPushButton *printButton; 

15 private slots: 

16 void printSlot(); 

17 protected: 

18 virtual void paintEvent(QPaintEvent *); 

19}; 

20 

21 #endif 
PrintGraphic 

1 /* printgraphic.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include <qprinter.h> 

5 #include "printgraphic.h" 





7 int main(int argc,char **argv) 

8 { 

9 KApplication app(argc,argv, "printgraphic"); 

10 PrintGraphic printgraphic; 

11 printgraphic. sho w(); 

12 app.setMainWidget(&printgraphic); 

13 retum(app. exec()); 

14} 

15 PrintGraphic::PrintGraphic(QWidget *parent,const 

16 char *name) : QWidget(parent,name) 

17 { 

18 setFixedSize(450,250); 

19 printButton = new QPushButton("Print n ,this); 

20 printButton->setGeometry(370,200,70,40); 

21 connect(printButton,SIGNAL(clicked()), 

22 this,SLOT(printSlot())); 

23} 

24 void PrintGraphic :: paintEvent(QPaintEvent *) 

25 { 

26 QPainter paint; 

27 

28 paint.begin(this); 

29 paint.setBrush(QColor( n black")); 

30 paint.drawRect(50,75,350,100); 

31 paint.setBrush(QColor("white n )); 

32 paint.drawEllipse(l 50,50,150,150); 

33 paint.setPen(QWidget: :NoPen); 

34 paint.drawRect(100,100,250,50); 

35 paint.end(); 

36} 

37 void PrintGraphic::printSlot() 

38 { 

39 QPainter paint; 

40 QPrinter printer; 

41 
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42 if(printer. setup(this)) { 

43 paint.begin(&printer); 

44 paint.setBrush(QColor("black n )); 

45 paint.drawRect(50,75,350,100); 

46 paint.setBrush(QColor( M white")); 

47 paint.drawEllipse(l 50,50,150,150); 

48 paint.setPen(QWidget: :NoPen); 

49 paint.drawRect( 100,100,250,50); 

50 paint.endO ； 

51 } 

52} 



그림 13-3. 인쇄설정대화칸 
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15 행 의 구성 자는 창문크기 를 설 정 하고 오른쪽아래 구석 에 단추를 설 치한다 . 처 리 부메 쏘 
드 printSlot() 는 단추에 련결된다 . 

24 행의 paintEvent() 메쏘드는 창문부품의 창문에 도형을 그린다 . 

37 행의 처리부메쏘드 printSlotO 는 사용자에게 인쇄기환경설정을 의뢰하고 사용자가 그 
림 13-3 에 보여준 대화칸에서 OK 단추를 찰칵하면 인쇄기로 도형을 그린다 . 42 행의 setup() 호 
출은 대화칸을 펼치고 이때 TRUE 의 돌림값은 인쇄가 수행된다는것을 가리킨다 . 43 행의 
begin() 호출은 QPainter 객체를 인쇄기에 련결한다 . 

50 행의 end() 호출은 그리 기 를 끝내고 인쇄 기 에 도형 명 령 을 보낸다 . 이 호출은 또한 인쇄 
기에 대한 출력을 완료하고 인쇄용 완충기에 페지(또는 폐지들)를 보낸다 . 인쇄도중에 현재 
폐지를 취소하고 새 폐지를 인쇄하려고 한다면 다음 메쏘드를 호줄하면 된다 . 
print.newPageO ； 

인쇄과정의 임의의 시점에서 완충기에 인쇄하려는 모든 폐지를 보내지기전에 다음과 
같이 메쏘드를 호출하면 이미 보낸 폐지들을 삭제할수 있다 . 
print.abort () ; 


제3절. 인쇄기정보와 조종 

창문에 그리는것처럼 인쇄기로 인쇄하는것은 간단하지만 폐지크기와 인치당 점의 개수와 
갈은 정보를 알 필요가 있다 . 다음 실례프로그람은 그림 13-4 와 같이 기본인쇄기정보를 현시한 
다 . 이 프로그람을 실행하고 대화칸을 펼치여 인쇄기에 대한 환경설정을 진행할수 있다 . 



그림 13-4. 인쇄정보대화칸 


PrintMetrics 머 리 부과 일 
1 /* printmetrics.h */ 
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2 #ifndef PRINTMETRICS_H 

3 #define PRINTMETRICS_H 

4 

5 #include <qwidget.h> 

6 #include <qpushbutton.h> 

7 #include <qprinter.h> 

8 

9 class PrintMetrics: public QWidget 

10 { 

11 Q_OBJECT 

12 public: 

13 PrintMetrics(QWidget *parent=0,const char *name=0); 

14 private: 

15 QPrinter printer; 

16 QPushButton *printButton; 

17 private slots: 

18 void printSetupSlot(); 

19 protected: 

20 virtual void paintEvent(QPaintEvent *); 

21 }； 

22 

23 #endif 

QPrinter 객체는 클라스의 부분으로 포함된다 . 그것은 클라스의 성원이므로 사용자에 의 
한 어떠한 환경변화도 PrintMetrics 객체의 수명에 영향을 주지 않는다 . 

PrintMetrics 

1 /* printmetrics.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include <qpaintdevicemetrics.h> 

5 #include "printmetrics.h” 

6 

7 int main(int argc,char **argv) 

8 { 

9 KApplication app(argc,argv, ’’printmetrics"); 

10 PrintMetrics printmetrics; 
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11 printmetrics. show(); 

12 app.setMainWidget(&printmetrics); 

13 return (app.exec()); 

14} 

15 PrintMetrics: :PrintMetrics(QWidget *parent,const 

16 char *name) : QWidget(parent,name) 

17 { 

18 setFixedSize(450,250); 

19 printButton = new QPushButton("Printer Setup",this); 

20 printButton->setGeometry(340,200,90,40); 

21 connect(printButton,SIGNAL(clicked()), 

22 this,SLOT(printSetupSlot())); 

23} 

24 void PrintMetrics: :printSetupSlot() 

25 { 

26 printer.setup(this); 

27} 

28 void PrintMetrics :: paintEvent(QPaintEvent *) 

29 { 

30 QPainter paint; 

31 QPaintDeviceMetrics metrics(&printer); 

32 QString string; 

33 

34 paint.begin(this); 

35 

36 QFontMetrics fin = paint.fontMetrics(); 

37 intx = 20; 

38 inty = 20; 

39 

40 string = "Printer name: " + printer.printerName(); 

41 paint.drawT ext(x,y,string); 

42 y += fm.height(); 

43 


44 if(printer.outputToFile()) { 

45 string = "Output to file: 




46 + printer.outputFileName(); 

47 paint.drawText(x,y,string); 

48 y += fm.height(); 

49 } 

50 

51 if(printer.orientation() = QPrinter: : Portrait) 

52 string = "Orientation: portrait’’; 

53 else 

54 string = ’’Orientation: landscape"; 

55 paint.drawText(x,y,string); 

56 y += fm.height(); 

57 

58 string = "Number of copies: 

59 string += QString::number(printer.numCopies()); 

60 paint.drawText(x,y,string); 

61 y += fm.height(); 

62 

63 if(printer.colorMode() == QPrinter: : Grayscale) 

64 string = "Color mode: gray scale"; 

65 else 

66 string = "Color mode: color"; 

67 paint.drawText(x,y,string); 

68 y += fm.height(); 

69 

70 string = "Page width: 

71 string += QString: :number(metrics.width()); 

72 paint.drawText(x,y,string); 

73 y += fm.height(); 

74 

75 string = ’’Page height: 

76 string += QString: :number(metrics.height()); 

77 paint.drawText(x,y,string); 

78 y += fm.height(); 

79 


80 if(printer.fullPage()) 


321 






81 string = "Full page: true’’; 

82 else 

83 string = "Full page: false"; 

84 paint.drawText(x,y,string); 

85 y += fm.height(); 

86 

87 string = "Left and right margin width: 

88 string += QString::number(printer.margins().width()); 

89 paint.drawText(x,y,string); 

90 y += fm.height(); 

91 

92 string = ’’Top and bottom margin height: 

93 string += QString::number(printer.margins().height()); 

94 paint.drawText(x,y,string); 

95 y += fm.height(); 

96 

97 string = ’’Page width in millimeters: 

98 string += QString::number(metrics.widthMM()); 

99 paint.drawText(x,y,string); 

100 y+= fm.height(); 

101 

102 string = "Page height in millimeters: 

103 string += QString::number(metrics.heightMM()); 

104 paint.drawText(x,y,string); 

105 y+= fm.height(); 

106 

107 string = "Horizontal dots per inch: 

108 string += QString::number(metrics.logicalDpiX()); 

109 paint .drawText(x,y, string); 

110 y+= fm.height(); 

111 

112 string = "Vertical dots per inch: 

113 string += QString::number(metrics.logicalDpiY()); 

114 paint .drawText(x,y, string); 

115 y+= fm.height(); 
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116 

117 string = "Number of colors (or shades of gray): 

118 string += QString::number(metrics.numColors()); 

119 paint.drawText(x,y,string); 

120 y += fm.height(); 

121 

122 string = "Number of bits per dot: 

123 string += QString::number(metrics.depth()); 

124 paint.drawText(x,y,string); 

125 y += fm.height(); 

126 

127 paint.end(); 

128} 

24 행의 처리부메쏘드 printSetupSlotQ 는 그림 13-3 과 같이 인쇄기환경설정대화칸을 펼친 
다. 이것은 인쇄설정을 변경하는데 쓰인다. 

28 행의 paintEvent() 메쏘드는 현재 인쇄 기 설명정 보와 환경 의 목록을 현시 하는 창문을 만 
든다. 일부 정보는 QPaintDeviceM 的 ics 객체로부터 얻고 일부는 QPrinter 객체 자체로부터 직접 
얻 는다. 

36 행의 인쇄기이 름은 사용자가 사용가능한 인쇄기들의 목록으로부터 선택한 이름이 다. 
사용자가 인쇄 기 를 선택하지 않았다면 빈문자렬 이 printerNameO 에 의해 되 돌려 지 며 인쇄출 
력은 기정인쇄기에 대하여 진행된다. 출력이 기정인쇄기대신 파일에 대하여 진행되면 44 행 
의 outputToFileQ 호출은 TRUE 를 되돌려 주며 outpuffileNameO 호출은 파일이름을 되돌려 준다. 
파일이 인쇄될 때 인쇄된 자료는 postscript 형 식으로 파일에 보내진다. 

51 행의 orientation() 호출은 자료가 세로방식으로 인쇄되는가 가로방식으로 인쇄되는가 
가리킨 다. 기 정방식 은 세 로방식 이 다. 

59행의 numCopiesO 호출은 인쇄할 문서수를 되돌려주며 기정값은 1 이다. 

63 행의 colorMode() 호출은 인쇄할 때 방식을 알려준다. 

기행과 76 행은 인쇄가능구역의 폐지너 비와 높이를 지 정한다. 도형을 표시하기 위한 높 
이와 너비값은 필요하면 창문에 도형을 그릴 때처럼 이 수를 여백의 값들과 전폐지지시기와 
결합하여 사용할수 있다. 80 행의 MIPageO 호출이 TRUE 를 되돌려준다면 높이와 너비은 종이 
의 경계까지 늘어 난다. ftillPageO 가 FALSE 를 되돌려준다면 높이와 너 비는 여 백내의 치수이다. 
printer.setFullPage(TRUE) 를 호출하여 인쇄 기 를 완전폐지 방식 으로 설정할수 있다. 또는 
printer.seffullPage(FAL 況;)를 호출함으로써 폐 지크기 를 여 백 (기 정 )으로 조절 되 도록 설 정 할수 
있다. 

88행 과 93행 에 서 marginsG 호출에 의해 엄 은 여 백 값은 전폐 지 방식 이 아닐 때 실제 여백 



값이고 전폐지방식일 때 제안된 여백이다 . 

고정너비와 높이를 가지지 않는 창문과 달리 인쇄기는 고정적인 물리너비와 인치당 점 
의 개수를 가지므로 이 값들을 결정할수 있다 . 그러나 인쇄기가 콤퓨터에 값들을 통보하지 
않을수 있으므로 수값들을 전적으로 믿을수는 없으며 또한 인쇄기환경이 잘못되거나 사용자 
가 파일을 출력하려고 선택하였을수 있다 . 어쨌든 폐지의 너비와 높이는 98 행과 103 행에서 
mm 로 통보되며 인치당 점의 개수는 108 행과 113 행에서 통보된다 . 

점당 총색 수(또는 회색 그늘수)는 118 행의 numColorsO 호출로부터 엄는다 . 같은 정보는 
또한 123 행의 depth() 호출에서 매 점의 비트수로 통보된다 . 

제4절. 창문에 그림믈 맞추기 

자체의 자리표계를 설정하고 그것을 리용하여 창문에 도형을 그리고 자리표계를 실제 
창문의 자리표계로 자동적으로 변환할수 있다 . 다음 실례는 그 방법을 보여준다 . 

FitWindow 머 리 부파일 

1 /* fitwindow.h */ 

2 #ifndef FITWINDOW_H 

3 #defme FITWINDOW_H 

4 

5 #include <qwidget.h> 

6 

7 class FitWindow: public QWidget 

8 { 

9 protected: 

10 virtual void paintEvent(QPaintEvent *); 

11}； 

12 

13 #endif 


FitWindow. 

1 /* fitwindow.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include ’’fitwindow.h" 



8 KApplication app(argc,argv, ’’fitwindow’’); 

9 FitWindow fitwindow; 

10 fitwindow. show(); 

11 app.setMainWidget(&fitwindow); 

12 return (app.exec()); 

13} 

14 void FitWindow: : paintEvent(QPaintEvent *) 

15 { 

16 QPainter p(this); 

17 

18 p.setWindow(0,0,300,300); 

19 

20 p.drawRoundRect(50,50,200,200,30,30 )； 

21 p.setBrush(QColor( M black "))； 

22 p.drawEllipse(100,100,100,100); 

23 p.setBrush(QColor("white "))； 

24 p.drawPie(50,50,100,100,270*16,90*16); 

25 p.drawPie(150,150,100,100,90* 16,90* 16); 

26} 

18 행의 setWindow() 호출은 자리 표계 의 원점으로서 왼쪽웃구석 을 설정한다. 또한 창문의 
높이와 너 비를 모두 300 으로 설정한다. 창문에 그릴 때마다 300x300 크기는 그림치수로 가정 
되지만 실제 화소들이 그려질 때 그것들은 실제창문크기로 변환된다. 그림 13-5 는 2 가지 다 
른 방법으로 크기를 조절한 후에 이 프로그람으로부터 현시된 창문을 보여준다. 



그림 13-5. 창문크기변 화에 따르는 도형 의 변화 














제 5 절. 보조참문에 그림을 맞추기 


이전 실례의 setWindow () 메쏘드는 창문안의 보조창문에 맞게 그리기와 칠하기가 비례되 
도륵 하기 위하여 se tViewport () 와 결합하여 사용할수 있다 . 다음 실례는 창문안의 4 개 보조 
창문으로 같은 그리기를 사영하여 그림 13-6 에 보여주는 현시를 만든다 . 



그림 13-6. 같은 창문에 4 번 나타나는 같은 도형 
FitSubWindow 머 리 부파일 
1 /* fitsubwindow.h */ 


2 #ifodef FITSUBWINDOW_H 

3 #defme FITSUB WINDO W_H 

4 

5 #include <qwidget.h> 

6 #include <qpainter.h> 

7 

8 class FitSubWindow: public QWidget 

9{ 

10 public: 

11 FitSubWindow(QWidget *parent=0,const char *name=0); 



13 void paintF igure(QPainter &); 

14 protected: 

15 virtual void paintEvent(QPaintEvent *); 
16 }； 

17 


18 #endif 
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FitSubWindow 


1 /* fitsubwindow.cpp */ 

2 #include <kapplication.h> 

3 #include "fitsubwindow.h" 

4 

5 int main(int argc,char **argv) 

6 { 

7 KApplication app(argc,argv,”fitsub window”); 

8 FitSubWindow fitsubwindow; 

9 fitsubwindow.show(); 

10 app.setMainWidget(&fitsubwindow); 

11 return (app.exec()); 

12 } 

13 FitSubWindow :: FitSubWindow(QWidget *parent, 

14 const char *name) : QWidget(parent,name) 

15 { 

16 setFixedSize(300,200); 

17} 

18 void FitSubWindow::paintEvent(QPaintEvent *) 

19 { 

20 QPainter p(this); 

21 

22 p.setViewport(0,0,100,50); 

23 paintFigure(p); 

24 p.setViewport(100,0,200,50); 

25 paintFigure(p); 

26 p.setViewport(0,50,100,150); 

27 paintFigure(p); 

28 p.setViewport(100,50,200,150); 

29 paintFigure(p); 

30} 

31 void FitSubWindow: :paintFigure(QPainter &p) 

32 { 

33 p.setWindow(0,0,300,300); 






34 p.setBrush(QColor("white "))； 

35 p.drawRoundRect(50,50,200,200,30,30 )； 

36 p.setBrush(QColor("black")); 

37 p.drawEllipse( 100,100,100,100); 

38 p.setBrush(QColor("white "))； 

39 p.drawPie(50,50,100,100,270* 16,90* 16); 

40 p.drawPie(150,150,100,100,90* 16,90*16); 

41 } 

구성자는 16 행의 setFixedSize () 호출에 의해 300X200 화소 크기로 창문크기를 고정한다 . 
18 행의 paintEvent () 메 쏘드는 창문이 그려 질 때마다 호출되며 setViewportO 와 paintFigureO 의 4 
번의 호출이 그림 13-6 에 보여준 창문을 그리게 한다 . 

22 행의 setViewportO 호출은 위치가 (0,0 ) 인 왼쪽웃구석으로부터 도형을 그리며 100><50 화 
소로 그리기령 역을 제한한다 . 23 행의 paintFigureO 호출은 화소들의 실제그리기 를 진행한다 . 같 
은 방식으로 setViewportO 의 첫 호출에서 보조창문을 지정하고 그다음 도형을 그리는 
paintFigureO 를 호출함으로써 보기구역(보조창문)에 3 가지 다른 도형을 그린다 . 

31 행에서 메쏘드 paintFigureO 은 도형을 그린다 . 33 행에서 setWindowO 를 호출하여 창문 
이 왼쪽웃구석을 원점으로 하여 300x300 화소크기의 바른 4 각형구역에 그려지도록 한다 . 도형 
은 그다음 원시 그리기 메쏘드 drawRoundRect(), drawEllipse(), drawPie () 를 호출함으로써 300x300 
정방형에 그러진다 . 화소들의 물리적위치와 결과그림의 가로세로비는 painffigureO 호출에 앞 
서 setViewportO 호출에 의 해 설정 된다 . 이 것은 paintFigureO 메쏘드가 독립 적으로 실제화소위 치 
들의 도형을 계산하여 그리게 한다 . 


제6절. 오려내기 

그리기를 특정한 령 역으로 제한할수 있다 . 즉 령 역밖에서의 모든 그리기는 잘리우고 그 
려지지 않게 할수 있다 . 다음 실례는 3 개의 다른 솔을 사용하여 같은 타원을 그리지만 2 번 
째와 3 번째 타원은 원시타원이 여전히 부분적으로 보이도록 잘리운다 . 

ClipArea 

1 /* cliparea.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include <qbrush.h> 

5 #include <qpointarray.h> 

6 #include "cliparea.h" 

7 

8 int main(int argc,char **argv) 
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9{ 

10 KApplication app(argc,argv, ’’cliparea"); 

11 ClipArea cliparea; 

12 cliparea.show(); 

13 app.setMainWidget(&cliparea); 

14 return (app.exec()); 

15} 

16 ClipArea: : ClipArea(QWidget ^parent, 

17 const char *name) : QWidget(parent,name) 

18 { 

19 setFixedSize(300,200); 

20 } 

21 void ClipArea: :paintEvent(QPaintEvent *) 

22 { 

23 QPainter p(this); 

24 

25 p.setBrush(QColor("white M )); 

26 p.drawEUipse(25,25,250,150); 

27 

28 p.setBrush(QBrush(QColor("black M ),Qt::VerPattem)); 

29 p.setClipRect(30,30,70,70); 

30 p.drawEllipse(25,25,250,150); 

31 

32 p.setBrush(QBrush(QColor( n black n ),Qt::Dense5Pattem)); 

33 QPointArray pa; 

34 pa.setPoints(3,100,140,200,50,220,180); 

35 QRegion region(pa); 

36 p. setClipRegion(region); 

37 p.drawEllipse(25,25,250,150); 

38} 

25 행의 setBrushO 호출과 26 행의 drawEllipseO 호출은 그림 13-7 과 같이 흑색륜곽으로 백 
색타원을 그린다 . 
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그림 13-7. 오려 내 기 와 각이한 솔로 그린 타원 

28 〜 30 행은 타원의 왼쪽웃구석에 수직선들을 그린다 . 솔은 흑색 VerPattem 으로 설정되므 
로 수직선들이 만들어지며 29 행의 setClipRect() 호출은 70x70 화소 크기의 직 4 각형구역으로 그 
리기를 제한하며 위치 (30,30) 에 그 왼쪽구석이 있다 . 30 행의 drawEllipse() 호출이 전체 도형을 
그리지만 실제그리기는 오려낸 구역으로 제한된다 . 또한 솔폐턴이 배경을 보이게 하므로 원 
시타원의 부분도 역시 보인다 . 

갈은 기술은 타원오른쪽의 3 각형구역을 칠하는데 사용된다 . 

이 런 경우에 잘라낸 령역은 36 행의 setClipRegionO 호출에 의해 정의 된다 . pa 라는 
QPointArray 는 오직 3 각형의 3 개 점만 포함하지만 자기가 정의 하려고하는 복잡한 다각형들 
도 포함할수 있다 . 

또한 1 개의 오려낸 령역만 정의할수 있으므로 새로운 오려내기령역의 정의는 이전의 
령 역을 삭제한다 . 오래낸 령 역을 금지하려고 한다면 setClippingO 메쏘드를 다음과 같이 호출 
할수 있다 . 

p.setClipping(FALSE);. 


제7절. 확대축소 

그림을 그리기 에 앞서 QPainter 에서 자리 표들을 변경 하여 크거나 작게 그림을 확대 축소 
할수 있다 . 다음 실례는 크기를 변경하고 픽스매프를 그린 결과를 보여준다 : 

ScaleShape 머 리 부파 일 

1 /* scaleshape.h */ 

2 #ifndef SCALESHAPE_H 

3 #define SCALESHAPE_H 

4 

5 #include <qwidget.h> 

6 
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7 class ScaleShape: public QWidget 
8{ 

9 public: 

10 ScaleShape(QWidget *parent=0,const char *name=0); 

11 private: 

12 QPixmap marble; 

13 protected: 

14 virtual void paintEvent(QPaintEvent *); 

15 }； 

16 

17 #endif 
ScaleShape. 

1 /* scaleshape.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include "scaleshape.h" 

5 

6 #include ’’bluemarble.xpm” 

7 

8 int main(int argc,char **argv) 

9{ 

10 KApplication app(argc,argv, "scaleshape"); 

11 ScaleShape scaleshape; 

12 scaleshape.show(); 

13 app. setMain W idget(&scaleshape); 

14 return (app.exec()); 

15} 

16 ScaleShape::ScaleShape(QWidget *parent,const 

17 char *name) : QWidget(parent,name) 

18 { 

19 marble = QPixmap(magick); 

20 setFixedSize(360,288); 

21 } 

22 void Scale Shape :: paintEvent(QPaintEvent *) 

23 { 


331 



24 QPainter p(this); 

25 

26 p.drawPixmap(0,0,marble); 

27 p.scale(2.0,2.0); 

28 p.drawPixmap(36,0,marble); 

29 p.scale(l.0,2.0); 

30 p.drawPixmap( 108,0,marble); 

31} 

6 행에 포함된 XPM 파일은 19 행에서 QPixmap 로 변환된다 . 픽스매프는 72x72 화소이다 . 

26 행의 drawPixmapO 호출은 그림 13-8 과 같이 창문의 왼쪽웃구석에 본래 크기로 픽스매 
프를 그린다 . 

기정비례값들은 표와 y 축에서 모두 1.0 이다 . scaleO 은 두 값의 2 배크기로 호출한다 . 27 행 
의 scale() 호출은 표와 y 방향의 비례가 2 배하므로 28 행의 drawPixmapO 호출은 픽스매프를 처음 
것의 2 배로 그린다 . drawPixmapO 호출에서 본래크기의 2 배 즉 72 화소로 확대된 그림을 자리 
표의 오른쪽으로 36 화소만큼 옳긴다 . 29 행의 scale() 호출은 현재 비례에 2.0 이 아니라 1.0 을 
급하므로 x 축의 비 례를 변경 하지 않지 만 y 축의 비 례를 두배로 하여 수직비 례요소가 4.0 이 
되게 한다 . 30 행의 drawPixmapO 호출은 적스매프를 원래 크기의 두배의 너비와 4 배의 높이로 
그린다 . 



그림 13-8. 3 개의 각이한 비 례로 그린 픽스매프 





제 8 절. 경사지기 


도형을 경사지게 한다는것은 X 축과 수평으로 놓이지 않거나 y 축과 수직으로 놓이지 않 
거나 또는 x 와 y 축에 모두 수평 및 수직으로 놓이지 않도륵 도형 이 기울어지게 하는것이다 . 
y 축의 경사도를 증가시키면 도형의 아래를 오른쪽으로 이동하고 x 축의 경사도를 증가시키면 
도형의 오른쪽끝을 아래로 이동한다 . 이동량은 창문크기에 따라 결정된다 . 부의 경사도는 축 
을 반대방향으로 이동한다 . 실례로 창문이 100 화소너비이면 x 축의 경사도 0.5 는 그림의 오른 
변을 50 화소 아래로 이동하며 1.0 의 경사도는 오른변을 100 화소 아래로 이동하며 경사도 
-1.0 은 오른쪽을 100 화소 우로 이동한다 . 

다음 실례는 표와 y 방향 모두에서 경사지게 한 결과를 보여준다 . 그림 B-9 에서는 x 경사 
도 1.0, 경사도없음，그리고 y 경사도 1.0 으로 그린 같은 도형들(왼쪽에서 오른쪽으로)을 보여 
준다 . 



그림 13-9. 수직경사지기 , 경사없음，수평경사지기 

ShearShape 머 리 부파 일 

1 /* shearshape.h */ 

2 #ifodef SHEARSHAPE_H 

3 #define SHEARSHAPE_H 

4 

5 #include <qwidget.h> 

6 

7 class ShearShape: public QWidget 
8 { 

9 public: 

10 ShearShape(QWidget *parent=0,const char *name=0); 

11 private: 

12 QPixmap marble; 

13 protected: 





14 virtual void paintEvent(QPaintEvent *); 

15 }； 

16 

17 #endif 
ShearShape 

1 /* shearshape.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include "shearshape.h" 

5 

6 #include ’’bluemarble.xpm" 

7 

8 int main(int argc,char **argv) 

9{ 

10 KApplication app(argc,argv, "shearshape"); 

11 ShearShape shearshape; 

12 shearshape.show(); 

13 app.setMainWidget(&shearshape); 

14 return (app.exec()); 

15} 

16 ShearShape :: ShearShape(QWidget *parent,const 

17 char *name) : QWidget(parent,name) 

18 { 

19 marble = QPixmap(magick); 

20 setFixedSize(288,144); 

21 } 

22 void ShearShape :: paintEvent(QPaintEvent *) 

23 { 

24 QPainter p(this); 

25 

26 p.shear(1.0,0.0); 

27 p.drawPixmap(0,0,marble); 

28 p.shear(-l.0,0.0); 

29 p.drawPixmap(72,0,marble); 

30 p.shear(0.0,1.0); 




31 p.drawPixmap(144,0,marble); 

32} 

6 행에 포함된 XPM 파일은 19 행에서 QPixmap 로 변환된다 . 26 행의 shear () 호출은 모든 수 
평선들이 오른쪽으로 45 도 이울어져서 그려지도록 x 축의 오른쪽끝을 낮춘다 . 27 행의 
drawPixmap () 호출결과는 그림 13-9 의 왼쪽에 있는 경사진 픽스매프이다 . 

28 행의 shear () 호출은 이전의 shear () 호출의 동작을 반대로 하며 29 행의 drawPixmap () 호출 
에 의해 도형 은 경사지 지 않고 그러 진다 . 30 행의 shear () 호출은 y 축의 경사도를 조절하고 31 
행의 drawPixmapO 호출은 그림 13-9 의 오른쪽에 보여주는 픽스매프를 생성한다 . 

제9절. 변환 

그리기의 원점은 보통 창문의 왼쪽웃구석이지만 다른 장소로 옮길수 있다 . 일단 옮기면 
y 값은 원점아래로 옮겨지고 x 값은 오른쪽으로 옮겨지며 원점의 우와 왼쪽의 위치들은 부의 
자리표값으로 설정된다 . 다음 실례는 원점을 창문중심으로 변환하고 그 주위에 픽스매프들 
을 현시한다 . 

TranslateShape 머 리 부파일 

1 /* translateshape.h */ 

2 #ifndef TRANSLATESHAPE_H 

3 #defme TRANSLATESHAPE_H 

4 

5 #include <qwidget.h> 

6 

7 class TranslateShape: public QWidget 

8 { 

9 public: 

10 TranslateShape(QWidget *parent=0,const char *name=0); 

11 private: 

12 QPixmap marble; 

13 protected: 

14 virtual void paintEvent(QPaintEvent *); 

15 }； 

16 

17 #endif 
TranslateShape 

1 /* translateshape.cpp */ 

2 #include <kapplication.h> 



3 #include <qpainter.h> 

4 #include "translateshape.h M 


6 #include "bluemarble.xpm" 

7 

8 int main(int argc,char **argv) 

9{ 

10 KApplication app(argc,argv, "translateshape' 1 ); 

11 Translate Shape translateshape; 

12 translateshape. show(); 

13 app.setMainWidget(&translateshape); 

14 return (app.exec()); 

15} 

16 TranslateShape::TranslateShape(QWidget *parent,const 

17 char *name) : QWidget(parent,name) 

18 { 

19 marble = QPixmap(magick); 

20 setFixedSize(180,180); 

21 } 

22 void Translate Shape :: paintEvent(QPaintEvent *) 

23 { 

24 QPainter p(this); 

25 

26 p.translate(90,90); 

27 p.drawPixmap(-72,-72,marble); 

28 p.drawPixmap(0,0,marble); 

29} 

6 행에 포함된 XPM 파일은 19 행에서 QPixmap 로 변환된다 . 26 행의 translateO 호출은 창문 
의 위치 (: 90,90 ᅵ으로 모든 그림의 원점을 이동한다 . 변환된 원점을 리용하여 27 행의 
drawPixmap 호출은 창문에서 보통 위치 (18,18) 로 픽스매프의 왼쪽웃구석을 배치한다 . 28 행의 
drawPixmapO 호출은 퍽스매프의 왼쪽웃구석을 새로운 원점 즉 (90,90) 인 점에 배치한다 . 결과 
창문은 그림 13-10 에서 보여준다 . 





그림 13-10. 새 원점으로부터 픽스매프들의 배치 


제10절. 회전 


전체자리 표계를 원점주위로 회전할수 있다 . 표시 장치에서 기정 원점은 왼쪽웃구석으로서 
일반적인 도형현시에서 회전중심의 유효위치로 리용하지 않는다 . 다음 실례는 원점변환을 
리용하여 픽스매프의 중심에 회전중심을 배치한다 . 

RotateShape 머 리 부과 일 

1 /* rotateshape.h */ 

2 #ifndef ROTATESHAPE_H 

3 #defme ROTATESHAPE_H 

4 

5 #include <qwidget.h> 

6 

7 class RotateShape: public QWidget 

8 { 

9 public: 

10 RotateShape(QWidget *parent=0,const char *name=0); 

11 private: 

12 QPixmap marble; 

13 protected: 

14 virtual void paintEvent(QPaintEvent *); 

15 }； 

16 

17 #endif 
RotateShape 

1 /* rotateshape.cpp */ 
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2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include M rotateshape.h n 

5 

6 #include ’’bluemarble.xpm’’ 

7 

8 int main(int argc,char **argv) 

9{ 

10 KApplication app(argc,argv, "rotateshape"); 

11 RotateShape rotateshape; 

12 rotateshape. show(); 

13 app.setMainWidget(&rotateshape); 

14 return (app.exec()); 

15} 

16 RotateShape::RotateShape(QWidget *parent,const 

17 char *name) : QWidget(parent,name) 

18 { 

19 marble = QPixmap(magick); 

20 setFixedSize(320,160); 

21 } 

22 void RotateShape :: paintEvent(QPaintEvent *) 

23 { 

M QPainter p(this); 

25 

26 p.translate(80,80); 

27 p.rotate(20.0); 

28 p.drawPixmap(-36,-36,marble); 

29 p.rotate(-20.0); 

30 p.translate(80,0); 

31 p.rotate(40.0); 

32 p.drawPixmap(-36,-36,marble); 

33 p.rotate(-40.0); 

34 p.translate(80,0); 

35 p.rotate(60.0); 

36 p.drawPixmap(-36,-36,marble); 
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37} 

6 행의 XPM 파일은 19 행에서 QPixmap 로 변환된다 . 26 행의 tanslate() 호출은 창문의 위치 (80, 
80) 에로 원점을 이동한다 . 27 행의 rotateO 호출은 원점주위의 자리표계를 20° 회전시킨다 . 28 행의 
drawPixmap() 호출은 원점을 중심으로 하여 픽스매프를 그린다(픽스매프는 72X72 화소크기 ). 

그림 13-11 에 보여준것처럼 두번째 픽스매프그림은 첫째의 오른쪽에 중심에 직접 배치 
된다 . 이전 회전설정 이 남아있으면 30 행 에서 원점을 20 ᄋ각도로 오른쪽과 아래로 변화시킨다 . 
이것을 막기 위하여 회전값을 반대로 0 으로 설정함으로써 이전의 회전을 반전시키고 30 행에 
서 translate() 호출로 원점을 오른쪽으로 직접 이동하게 한다 . 원점이 이동한 후에 31 행의 
rotate() 호출은 둘째 픽스매프의 회전량을 40° 로 설정하고 32 행의 drawPixmap() 호출에 의해 그 
려진다 . 같은 방법으로 회전은 33 행에서 삭제하여 34 행에서 translate 0 호출을 허용하고 원점 
을 다시 한번 오른쪽으로 이 동한다 . 그다음 회 전은 마지 막 drawPixmap() 호출을 위해 35 행 에 
서 60° 로 설정된다 . 



그림 13-11. 3 개 원점주위로 픽 스매프들을 회 전시키 기 


제11절. 2차베_곡선 


QPointArray 클라스는 4 개의 점으로 베찔곡선을 생성하는데 쓰이는 메쏘드를 가지고있다 . 
그림 13-12 는 아래의 프로그람의 실행결과를 보여준다 . 



그림 13-12. 4 개 의 점 으로 만들어 진 베 썰곡선 
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QuadBezier 

1 /* quadbezier.cpp */ 

2 #include <kapplication.h> 

3 #include <qpen.h> 

4 #include ’’quadbezier.h" 

5 

6 int main(int argc’char **argv) 

V{ 

8 KApplication app(argc,argv,”quadbezier’’); 

9 QuadBezier quadbezier; 

10 quadbezier. show(); 

11 app.setMainWidget(&quadbezier); 

12 return (app.exec()); 

13} 

14 QuadBezier: :QuadBezier(QWidget ^parent, 

15 const char *name) : QWidget(parent,name) 

16 { 

17 setFixedSize(300,200); 

18} 

19 void QuadBezier: : paintEvent(QPaintEvent *) 

20 { 

21 static QCOORD points[] = 

22 { 20,20, 80,180,210,20, 280,100 }; 

23 QPointArray pa(4,points); 

24 QPainter p(this); 

25 

26 p.setPen(QColor(“white”)); 

27 paintPoints(p,pa); 

28 QPointArray bpa = pa.quadBezier(); 

29 p.setPen(QColor( << black^ , )); 

30 p. drawPolyline(bpa); 

31} 

32 void QuadBezier::paintPoints(QPainter &p,QPointArray &pa) 

33 { 

34 int x; 
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35 inty; 

36 

37 for(int i=0; i<pa.size〔); i++) { 

38 pa.point(i,&x,&y); 

39 p.drawLine(x-5,y,x+5,y); 

40 p.drawLine(x,y-5,x,y+5); 

41 } 

42} 

23 행에서 pa 라는 QPointArray 객체는 4 개의 점을 포함하도록 창조된다 . 26 행은 백색펜을 
지 정하므로 27 행의 paintPoints () 호출은 백 색으로 점위 치들을 지 적한다 . 28 행의 quadBezier () 호 
출은 4 개의 원점을 사용하여 점모임을 포함하는 새로운 QPointArray 객체를 만들며 첫점과 
넷째 점이 그 점들사이의 2 차베쎌곡선의 궤적을 표현하고 2 개 중점에 의해 모양이 정해진다 . 
29 행과 30 행 에서 setPen () 과 drawPolyline () 호출은 곡선을 흑색으로 그린다 . 

32 행의 paintPoints () 메쏘드는 QPointArray 에서 매 점의 위치에 10x10 화소크기의 《+》문 
자를 배 치한다 . 순환에 서 point () 호출에 의해 점 의 표와 y 값들이 되 돌아오고 그다음 drawLine() 
를 두번 호출하는데 한번은 수직선을 그리고 다음에는 수평선을 그린다 . 이리하여 점을 표 
시한다 . 


제12절. 픽스매프렬에 의한 동화 

동화처리는 프레임들을 하나씩 현시하는 문제이다 . 이 프레임들은 파일로부터 적재된 
화상들의 렬 ( 영화부류)일수 있으며 또는 표준도형함수를 사용하여 그릴수 있다 . 다음 실례는 
픽스매프를 사용하여 그림 13-13 에 보여준 튀는 공들을 그리고 동화시킨다 . 



# 

o 

# 

o _ 

그림 13-13. 튀는공의 동화 
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Ball 머 리 부파일 

1 /* ballh */ 

2 #ifiidefBALL_H 

3 #define BALL_H 

4 

5 #include <qcolor.h> 

6 

7 #define RADIUS 7 

8 

9 class Ball 

10 { 

11 public: 

12 Ball(int width,int height); 

13 private: 

14 double x; 

15 double y; 

16 double xV elocity; 

17 double yVelocity; 

18 QColor *color; 

19 public: 

20 double getDiameter() { retum(RADIUS * 2.0); } 

21 double getX() { retum(x); } 

22 double getY() { retum(y); } 

23 double getXVelocity() { retum(xVelocity); } 

24 double getYVelocity() { retum(yVelocity);} 

25 QColor &getColor() { retum(*color); } 

26 void setXVelocity(double value) { xVelocity = value; } 

27 void setYVelocity(double value) { yVelocity = value; } 

28 void nextPosition(); 

29}; 

30 

31 #endif 

매개 공은 7 행에서 정의한것처럼 갈은 반경을 가전다 . 어떤 주어진 순간에 창문에서 공 
의 위치는 14 행과 15 행에서 값 표와 y 에 의해 지정된다 . 공의 수평속도는 xVelocity 에 의해 
지정되는데 이 값은 오른쪽으로 이동하면 정수로，왼쪽으로 이동하면 부수로 된다 . 공이 아 




태로 움직이고 있으면 yVelocity 의 수직속도값은 정수이고 우로 움직이고 있으면 부수이다. 
매개 공은 18 행에서 정의된것처럼 자체의 색을 가지고있다. 

20〜25행에서 정의된 메쏘드들은 Ball 클라스에 보관된 값의 호출을 제공한다. 26행과 27 
행의 메쏘드 setXVelocityO 와 setYVelocityO 는 공의 속도를 설정하는데 쓰인다. 

Ball 

1 /* ball.cpp */ 

2 #include <stdlib.h> 

3 #include "balLh" 

4 

5 Ball::Ball(int width,int height) 

6 { 

7 x = (((double)rand()*width)/RAND_MAX); 

8 y = (((double)rand()*height)/RAND_MAX) - height; 

9 yVelocity = 0.0; 

10 do { 

11 xVelocity = (((double)rand()*4)/RAND_MAX) - 2; 

12 } while(fabs(xVelocity) < 0.5); 

13 color = new QColor(rand() % 255, 

14 rand() % 255, 

15 rand() % 255); 

16} 

17 void Ball: : nextPosition() 

18 { 

19 x += xVelocity; 

20 y += yVelocity; 

21 } 

5 행의 구성자는 위치，속도，공의 색을 우연설정값으로 초기화한다. 공은 창문의 두 경 
계사이에서 수평으로 그리고 창문의 어떤 위치에서 수직으로 배치되지만 보임창문높이의 2 
배이상으로 되지 않는다. 수직속도는 중력이 공을 아래로 가속시키므로 0으로 설정된다. 10 
행의 순환은 수평속도가 공이 수직으로 너무 길게 튀지 않도록 일정하게 한다. 색은 우연 
RGB 값으로 설정된다. 

17 행의 nextPosition() 메쏘드는 공을 현재상태에서 다음 위치에로 이동하기 위해 호출된 
다. 이것은 간단히 속도량을 현재위치에 추가하여 수행한다. 속도의 크기는 공이 얼마나 멀 
리 움직이는가를 결정하며 속도의 부호는 그 방향을 결정한다. 

Bounce 머 리 부파일 



I /* bounce.h */ 

2#ifndefBOUNCE_H 

3 #defme BOUNCE_H 

4 

5 #include <qwidget.h> 

6 #include <qtimer.h> 

7 #include <qpixmap.h> 

8 #include "balLh" 

9 

10 #define BOUNCE_HEIGHT 250 

II #defme BOUNCE_WIDTH 450 

12 #define BALL_COUNT 10 

13 #defme GRAVITY 0.2 

14 

15 class Bounce: public QWidget 

16 { 

17 Q_OBJECT 

18 public: 

19 Bounce(QWidget *parent=0,const char *name=0); 

20 private: 

21 QTimer *timer; 

22 QPixmap *pixmap; 

23 Ball *ball[BALL_COUNT]; 

24 private slots: 

25 void frameSlot(); 

26 protected: 

27 virtual void paintEvent(QPaintEvent *); 

28}; 

29 

30 #endif 

Bounce 클라스는 공들을 현시하는데 사용될 창문을 포함하는 창문부품이다 . 10 〜 13 행에 
서 정의된 상수값들은 창문의 높이와 너비 , 공의 개수 , 그리고 공을 아래로 가속시키는 중력 
을 결 정한다 . 

21 행 에서 정의 한 QTimer 는 프레 임 들사이의 시격을 지 정하는데 사용된다 . 22 행의 
QPixmap 는 창문에 매개 프레 임을 현시하기전에 그것을 그리는데 사용된다 . 23 행은 지적자배 





렬을 선언한다 . 

Bounce 

1 /* bounce.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include "bounce.h" 

5 

6 int main(int argc,char **argv) 

V{ 

8 KApplication app(argc,argv, "bounce"); 

9 Bounce bounce; 

10 bounce.show(); 

11 app. setMain Widget(&bounce); 

12 return (app.exec()); 

13} 

14 Bounce::Bounce(QWidget *parent,const 

15 char *name) : QWidget(parent,name) 

16 { 

17 setFixedSize(BOUNCE_WIDTH,BOUNCE_HEIGHT); 

18 timer = new QTimer(this, "clock"); 

19 connect(timer,SIGNAL(timeout()), 

20 this,SLOT(frameSlot())); 

21 timer->start(20); 

22 for(int i=0; i<BALL_COUNT; i++) 

23 ball[i] = new Ball(BOUNCE_WIDTH,BOUNCE_HEIGHT); 

24 pixmap = new QPixmap(BOUNCE_WIDTH,BOUNCE_HEIGHT); 
25} 

26 void Bounce :: paintEvent(QPaintEvent *) 

27 { 

28 QPainter paint; 

29 Ball *b; 

30 

31 paint.begin(pixmap); 

32 paint.eraseRect(0,0,BOUNCE_WIDTH,BOlJNCE_HEIGHT); 

33 for(int i=0; i<BALL_COUNT; i++) { 




34 b = ball[i]; 

35 paint. setBrush(b->getColor()); 

36 paint.drawEllipse(b->getX(),b->getY (), 

37 b->getDiameter(),b->getDiameter()); 

38 } 

39 paint.end(); 

40 bitBlt(this,0,0,pixmap,0,0, 

41 BOUNCE_WIDTH,BOUNCE_HEIGHT,CopyROP); 

42} 

43 void Bounce: : frameSlot() 

44 { 

45 Ball *b; 

46 

47 for(int i=0; i<BALL_COUNT; i++) { 

48 b = ball[i]; 

49 if((b- 〉 getX() >= BOUNCE_WIDTH) || 

50 (b->getX() < -b->getDiameter())) { 

51 delete b; 

52 ball[i] = new Ball(BOUNCE_WIDTH,BOUNCE_HEIGHT); 

53 continue; 

54 } 

55 if(b->getY() + b->getDiameter() >= BOUNCE_HEIGHT) { 

56 if(b->getYVelocity() > 0) 

57 b->setYVelocity(-b->getYVelocity() * 0.9); 

58 } else { 

59 b->setYVelocity(b->getYVelocity() + GRAVITY); 

60 } 

61 b->nextPosition(); 

62 } 

63 repaint(0,0,BOUNCE_WIDTH,BOUNCE_HEIGHT,FALSE); 

64 } 

14 행에서 시작하는 Bounce 구성자는 동화에 사용될 모든 객체를 만든다 . QTimer 는 동화 
의 속도와 프레 임들사이 에 경과시간의 비률을 조종하며 18 행에서 창조된다 . 19 행의 connect() 
호출은 처리부메쏘드 frameSlotO 에 시계를 련결하여 시계가 끝날 때마다 처리부가 호출되게 
한다 . 20 행의 start() 호출은 처리부메쏘드를 20ms(0.20s) 마다 호출하도록 한다 . 22 행의 순환은 



동화에 서 사용할 공들을 만들고 작업픽 스매 프는 24 행 에 서 창조된다 . 

paintEvent() 호출은 매개 공을 창문에서 그 현재 위치에 그린다 . 그리기는 창문부품의 창 
문이 아니라 픽 스매프에 수행된다 . 32 행의 eraseRect() 호출은 픽스매프를 지운다 . 매개 공의 
상세한 그리기는 33 행에서 시작하는 순환에서 수행된다 . 35 행의 setBrushO 호출은 현재솔을 
공의 색으로 설정하고 drawEllipse() 호출은 공객체의 정보를 리용하여 적합한 위치에서 색칠 
된 원을 그린다 . 

40 행에서 bitBlt() 함수호출은 창문부품의 창문에 직접 전체 픽스매프를 복사한다 . 그리기 
를 창문부품창문우에서 직접 진행하고 창문의 지우기와 다시그리기는 창문이 깜박거리게 한 
다 . 픽스매프그리기와 블로크로서의 화소복사는 깜빡거 림을 제거한다 . bitBlt() 에 넘긴 처음 3 
개 인수는 원천을 , 다음 3 개는 목적지 , 그리고 다음 2 개는 복사될 직 4 각형의 크기를 지정한 
다 . 마지막 인수는 화소자료의 전송방법을 지정한다 . CopyROP 선택은 매개 목적화소가 간단 
히 대응하는 원천화소에 다시 써진다는것을 지정한다 . 기타 많은 선택이 있는데 표 13-1 에 
보여 준다 . 


표 13-l.bitBlt() 에 의한 화소복사에 사용할수 있는 라스터조작 


이름 

목적지 

AndNotROP 

Source AND (NOT Destination) 

AndROP 

Source AND Destination 

ClearROP 

0 

CopyROP 

Source 

NandROP 

NOT (Source AND Destination) 

NopROP 

Destination 

NorROP 

NOT (Source OR Destination) 

NotAndROP 

(NOT Source) AND Destination 

NotCopyROP 

NOT Source 

NotOrROP 

(NOT Source) AND Destination 

NotROP 

NOT Destination 

NotXorROP 

(NOT Source) XOR Destination 

OrNotROP 

Source OR (NOT Destination) 

OrROP 

Source OR Destination 

SetROP 

1 

XorROP 

Source XOR Destination 


처리부메쏘드 frameSlot() 는 시계가 끝날 때마다 호출된다 . 이 메쏘드는 실제로 새 창문 
을 그리지 않지만 매개 공들의 다음 위치를 계산하고 그다음 63 행에서 repaint() 를 호출하여 
paintEvent() 호출을 예 정 한다 . repaint() 호출은 그리 려 는 직 4 각형 을 지 정 하고 (이 정 보는 
QPaintEvent 인수내 에서 paintEventO 에로 넘 어간다 ) 또한 창문이 처음에 지워지는가 하는것을 




지정 한다 . 동화에서 창문지우기선택 은 그렇게 하는것 이 깜박거 림을 다시 발생시키 므로 
FALSE 로 설정된다 . 

47 행에서 시작하는 순환은 매개 공의 다음 위치를 결정한다 . 49 행의 조건이 TRUE 이면 
공은 오른쪽 또는 왼 쪽으로 창문을 벗 어나므로 그것 은 삭제 되 고 새 로운 공으로 교체 된 다 . 55 
행은 공이 창문의 바닥에 있는가 하는것과 아래로 이동하고있는가(즉 그 수직속도가 정수이 
다 ) 결정하며 만일 그렇다면 속도를 반전하여 공이 우로 올라가게 한다 . 속도는 10 %만큼 감 
소되 므로(쓸림 으로 인한 에 네 르기 손실 ) 공은 매 번 전보다 낮게 튀여 오른다 . 공이 창문에서 
비행하고 있으면 59 행의 식은 중력의 량만큼 속도를 떨군다 . 끝으로 61 행의 nextPosition () 호 
출은 그 현재속도에 따라서 공의 표와 y 위치를 조정한다 . 

제13절. Qlmage 에 의한 화소값호출 

Qlmage 객체는 화상정보를 보관하고 개별적인 화소정보에 대한 저준위호출을 제공하는 
데 사용된다 . 다음 실례는 QPixmap 를 창조하고 그것을 Qlmage 로 변환하여 화소색값을 수정 
하며 그것을 다시 현시 용의 QPixmap 로 역변환한다 . Qlmage 의 3 가지 형식 이 있다 . 즉 화소당 
lbit, 8bit, 또는 32bit 를 포함할수 있다 . 

Qlmage 객체가 화소당 lbit 만 포함한다면 그다음 Qlmage 는 오직 흑백색도형정보를 가진 
다 . 실제로 lbit 값은 보통 흑백색을 포함하는 색략도의 색인으로 사용되지만 그것은 임의의 
2 가지 색을 포함할수 있다 . 이런 형의 Qlmage 객체에 색메쏘드와 기발들을 적용할수 있지만 
그것들은 효과가 없다 . 

사용되는 색모형에 따라 Qlmage 객체는 색략도에，또는 매개 화소위치에 직접 실제색자 
료를 기억할수 있다 (11 장에 설명 ). 프로그람은 어느 한 경우에 색을 변경할수 있다 . 색략도 
를 사용한다면 색 략도의 색 인 또는 색 략도자체 의 내 용을 변 경할수 있 다 . 색 략도가 사용되 지 
않는다면 매개의 개 별적 인 화소를 변경할수도 있다 . 

ImageModify 머 리 부파일 

1 /* imagemodify.h */ 

2 #ifndef IMAGEMODIFY_H 

3 #define IMAGEMODIFY_H 

4 

5 #include <qwidget.h> 

6 

7 class ImageModify: public QWidget 

8{ 

9 public: 

10 ImageModify(QWidget *parent=0,const char *name=0); 

11 private: 
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12 QPixmap logo; 

13 QPixmap modlogo; 

14 QRgb rgbModify(QRgb rgb); 

15 protected: 

16 virtual void paintEvent(QPaintEvent *); 

17}； 

18 

19 #endif 

12 행의 logo 픽스매프는 원시픽스매프를 보관하는데 사용되며 13 행의 modlogo 는 변경된 
픽스매프를 보관하는데 사용된다 . 

ImageModify 

1 /* imagemodify.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include <qimage.h> 

5 #include <qcolor.h> 

6 #include "imagemodify.h" 

7 

8 #include "logo.xpm" 

9 

10 int main(int argc’char **argv) 

11 { 

12 KApplication app(argc,argv, ’’imagemodify’’); 

13 ImageModify imagemodify; 

14 imagemodify. show(); 

15 app.setMainWidget(&imagemodify); 

16 retum(app. exec()); 

17} 

18 ImageModify: :ImageModify(QWidget *parent,const 

19 char *name) : QWidget(parent,name) 

20 { 

21 logo = QPixmap(magick); 

22 Qlmage image = logo.convertToImage(); 

23 if(image.numColors() >0) { 
for(int i=0; i<image.numColorsQ; i++) { 


24 
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25 QRgb rgbOrig = image.color(i); 

26 QRgb rgbMod = rgbModify(rgbOrig); 

27 image. setColor(i,rgbMod); 

28 } 

29 } else { 

30 for(int x=0; x<image.width(); x++) { 

31 for(int y=0; y<image.height(); y++) { 

32 QRgb rgbOrig = image.pixel(x,y); 

33 QRgb rgbMod = rgbModify(rgbOrig); 

34 image. setPixel(x,y,rgbMod); 

35 } 

36 } 

37 } 

38 modlogo.convertFromImage(image,ThresholdDither); 

39 setFixedSize(514,303); 

40} 

41 QRgb ImageModify :: rgbModify(QRgb rgb) { 

42 int alpha = rgb & OxFFOOOOOO; 

43 QRgb rgbMod = qRgb(qGreen(rgb) & OxCO, 

44 qRed(rgb) & OxCO, 

45 qBlue(rgb) & OxCO); 

46 rgbMod |= alpha; 

47 return (rgbMod); 

48} 

49 void ImageModify :: paintEvent(QPaintEvent *) 

50 { 

51 QPainter p(this); 

52 

53 p.drawPixmap(0,0,logo); 

54 p.drawPixmap(257,0,modlogo); 

55} 

18 행 에서 시 작하는 구성 자는 2 개 픽 스매 프를 만든다 . logo 라는 픽 스매 프는 8 행 에서 포함 
된 XPM 자료로부터 21 행에서 창조된다 . 22 행의 convertToImage() 호출은 QPixmap 객체의 내용 
을 리용하여 Qlmage 객체를 만든다 . 

23 행은 색모형을 결정한다 . numColors() 로부터 돌아온 값은 색략도에 보관된 색의 값이 





다. 수가 0이면 색략도는 없고 화소색은 직접 변경하여야 한다. 

24행에서 tj 는 순환이 색략도의 매개 항목에 대하여 한번만 실행되게 한다. 25행의 메쏘 
드 color () 는 QRgb 값으로서 색화소값을 얻는다. QRgb 자료형은 화소정보를 포함하는 unsigned 
옹근수이다 (11 장에서 설명). 즉 제일 왼쪽 바이트는 알파(투명성)값을 보관하고 다른 3 byte 는 
각각 3가지 색값을 하나씩 보관한다. 26행의 rgbModify () 호출은 화상으로부터 QRgb 값을 사용 
하여 새로운 QRgb 값을 창조하여 돌려준다. 27행의 setColorO 호출은 색표에서 같은 색인위치 
에 변경된 색값들을 보관한다. 색략도에 보관된 색값들을 직접 호출하므로 프로그람은 자기 
가 요구하는 변경을 할수 있다. 

색략도가 없다면 색은 Qlmage 의 매개 화소에 직접 보관된다. 30행과 31행의 순환은 모 
든 화소들을 순환하면서 Qlmage 의 높이와 너비값을 사용한다. 실제변환은 rgbModify () 메쏘드 
에 의하여 수행된다. 같은 메쏘드는 두 색모형의 인수들을 바꾸는데 사용된다. 색값들은 32 
행 에서 pixel () 호출에 의해 Qlmage 객체로부터 읽어 들이 며 변경 된 QRgb 값들은 34행의 
setPixel () 호출에 의해 Qlmage 객체에 써넣기된다. 

38행 의 convertFromlmageO 호출은 수정 된 화상자료를 픽 스매 프로 역변환하여 후에 현시 
할수 있게 한다. 메쏘드의 첫 인수는 Qlmage 객체이고 둘째 인수는 변환과정을 조종하는 기 
발들의 모임이다. 기발들은 표 13-2, 13-3, 13-4, 그리고 13-5 에서 보여주었으며 이 기발들 결 
합하여 사용할수 있다. 


표 13-2. QPixmap 를 창조하기 위한 색선택기발 


기발이름 

설명 

AutoColor 

이것은 기정이다. 화소당 lbit 이면 결과 QPixmap 는 흑백색이고 그렇지 않으 
면 한정값표현이 원색깊이로 진행되고 변환된다. 

ColorOnly 

QPixmap 는 한정값표현이 원색깊이로 진행되고 변환된다. 

MonoOnly 

결 과 QPixmap 는 훅백 색 이 다. 


표 13-3. QPixmap 를 창조하기 위한 한정 값표현법선택 기 발 


기발이름 

설명 

DiffuseDither 

이것은 기정값이다. 이것은 고품질결과를 산출하도록 설계된 한정값 

표현 알고리 듬이 다. 

OrderedDither 

이것은 속도와 효률을 위해 설계한 한정값표현알고리듬이다. 

ThresholdDither 

이 알고리듬은 한정값표현은 진행되지 않는다. 가장 가까운 색이 사 

용된 다. 


표 13-4. QPixmap 를 만들기 위한 알파통로 한정 값표현방식 선택기 발 


기발이름 

설명 

DiffuseAlphaDither 

이 것은 고품질결 과를 산출하도록 설계된 한정 값표현 알고리 듬이 
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다. 

OrderedAlphaDither 

이것은 속도와 효률을 위해 설계된 한정값표현알고리듬이 다. 

ThresholdAlphaDither 

이것은 기정으로서 한정값표현은 진행되지 않는다. 


표 13-5. QPixmap 를 만들기 위한 색 생성 선택기 발 


기발이름 

설명 

PreferDither 

이것은 기정값이다. 32 bit 화상들이 8 bit 화상으로 변환되고있을 때 항상 

32 bit 화상들을 한정값표현한다. 

AvoidDither 

8 bit 화상들로 변환되고있는 256개이상의 색을 포함하는 32 bit 화상들을 

한정 값표현 한다. 


41행의 메쏘드 rgbModifyO 는 실제색변환을 진행한다. 알과값은 색값의 첫바이트에 보관 
되고 이 변환방법 은 가변알파에 값을 보관하므로 후에 값을 변경된 색 으로 되 살릴수 있다. 
현존투명성정보를 얻으러고 할 때만 이것이 필요하다. 3개 표식 qGreen , qRed 그러고 qBlue 는 
3가지 색 값을 각각 얻 기 위한것 이 다. 매 개 색 은 변경 되 고(값 OxCO 과 비 트별 AND 함으로써) 
표식 qRgb () 는 3개의 개별적인 색값들을 rgbMod 라는 단일한 QRgb 자료형으로 결합한다. 원 
시알파값이 추가된다. 이 실례는 매개 색값으로부터 처음 2 bit 를 간단히 삭제하여 전체색분 
해능을 6 bit (매개 색 에 둘)로 효과적으로 줄인다. 또한 적색과 록색의 값이 바꿔여진다. 그림 
13-14 에서 는 왼쪽에 원시 픽 스매 프, 오른쪽에서 변경 된 적 스매프를 현시한다. 



그림 13-14. 알파를 적용한 실례 

화상에 적용될수 있는 색변환에는 제한이 없다. 실례로 모든 색정보를 삭제하고 회색의 
















도형을 만드는것은 간단히 적，록, 청값들을 평균함으로써 회색의 그늘을 만드는 문제이다. 
다음 rgbModify () 메쏘드는 알파투명도를 얻고 회색의 화상을 생성한다. 

QRgb ImageModify 2 :: rgbModify(QRgb rgb ) { 
int alpha = rgb & OxFFOOOOOO ; 
int average = qGreen ( rgb ) + qRed ( rgb ) + qBlue ( rgb ); 
average /= 3; 

QRgb rgbMod = qRgb ( average , average , average ); 

rgbMod |= alpha ; 

retnm ( rgbMod ); 


제 14 절. QFileDialog 에서 그림기호제공기의 리용 

매개 파일형들에 대하여 그림기호들을 사용자정의하는데 사용할수 있는 QFileDialog 를 
구축하는 수단이 있다. 그러자면 QFilelconProvider 를 창조하여 그림기호들을 제공하고 대화 
칸에 그것을 련결한다. 다음 실례는 일정한 확장자를 가진 파일들에 대하여 사용자정의그림 
기 호들을 정 의 하는 방법 을 설 명한다. 그림 13-15 에서 는 . png , .o 및 .cpp 로 끝나는 파일들에 
대하여 선택된 그림기호들을 보여준다. 



그림 13-15. 파일 형 을 가러 키 는 사용자정 의 그림 기 호들 

Mylcons 머 리 부파일 

1 /* myicons.h */ 

2 # ifndefMYICONS_H 

3 #defme MYICONS H 












5 #include < qfiledialog . h > 


7 class Mylcons : public QFilelconProvider 
8{ 

9 public : 

10 MyIcons(QWidget * parent =0 ,const char * name =0); 

11 〜 MyIcons (); 

12 const QPixmap * pixmap(const QFilelnfo &); 

13 const QPixmap * pixmap(const QUrllnfo &); 

14 private : 

15 const QPixmap * selectPixmap(QString &); 

16 private : 

17 QPixmap * cppPixmap ; 

18 QPixmap * oPixmap ; 

19 QPixmap * pngPixmap ; 

20 QPixmap * filePixmap ; 

21 QPixmap * directoryPixmap ; 

22 }; 

23 

24 #endif 

QFilelconProvider 기초클라스를 계승하는 Mylcons 클라스는 다른 파일형들을 가리키는데 
쓰이는 모든 픽스매프들을 가지고있다. 12행과 13행에서 선언된 pixmap () 라는 이름의 2가지 
메 쏘드는 기초클라스의 가상 메쏘드 들을 재정의한다. 이 2개 메 쏘드는 QFileDialog 에 의하여 
파일에 적합한 픽스매프를 얻는데 사용된다. 

Mylcons 

1 /* myicons.cpp */ 

2 #include < qfiledialog . h > 

3 #include "myicons 上’’ 

4 

5 static const char * file _ xpm []={ 

6 "22 22 6 1 ", 

7 ，’ c GrayO ", 

8 ，，. c Gray 51", 

9 "X c Gray 65", 
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0 

1 

2 

3 

4 

5 


20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35}; 

36 


’o c #dfdfdf M , 
’0 c GraylOO", 
’+ c None", 



，+ + + OOOOOOo + + + + + + + + + +，，, 
，+ + + 000000+ 0+ + + + + + + + +，，， 
，+ + + 000000+ Oo + + + + + + + +", 
'+ + + 000000 + + + + + + + +，’, 
，+ + + 000000000 + + + + + + + +，，, 
，+ + + OOOOOOO + + + + + + +，，, 
，+ + + 000000 .+ + .+ + + + + +，，， 

，+ + + 00000 .XX+ ..+ + + + +，，， 

，+ + + 00000 +X+ + .+ + + + + +，，, 

，+ + + 00000 + + + + .+ + + + + +，，, 

'+ + + 00000 .+ + X.. + + + + + ，，, 

'+ + + 000000 .+ + ..+ + + + + ", 

’+ + + OOOOOOO . + + + + ", 


，+ + + 0000000000 + + + +，，, 



37 static const char *directory_xpm[]= { 

38 ”15 15 6 1", 

39 c None", 

40 M b c #ffffOO", 

41 "d c #000000", 

42 ”* c #999999”, 

43 "a c #cccccc”, 
c c 


44 
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45 ” . ，，， 

46 "..*****. "， 

47 ’ ， .*ababa*. ，，, 

48 "*abababa******.", 

49 ”*cccccccccccc*d", 

50 ”*cbababababab*d", 

51 ”* cabababababa*d”, 

52 ”*cbababababab*d", 

53 ”*cabababababa*d ’’， 

54 ”*cbababababab*d", 

55 ”*cabababababa*d ’’， 

56 ”*cbababababab*d", 

57 n >i«*************(J n ? 

58 ".dddddddddddddd", 

59 ” ."}; 

60 

61 Mylcons: : MyIcons(QWidget ^parent,const char *name) 

62 : QFileIconProvider(parent,name) 

63 { 

64 cppPixmap = new QPixmap("idea.png"); 

65 oPixmap = new QPixmap("up.png"); 

66 pngPixmap = new QPixmap("flag.png n ); 

67 filePixmap = new QPixmap(filexpm); 

68 directoryPixmap = new QPixmap(directoryxpm); 

69} 

70 MyIcons:: 〜 MyIcons() 

71 { 

72 delete cppPixmap; 

73 delete oPixmap; 

74 delete pngPixmap; 

75 delete filePixmap; 

76 delete directoryPixmap; 

77} 

78 const QPixmap *MyIcons: :pixmap(const QFilelnfo &inf) 

79 { 
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80 QString name = inf.fileName(); 

81 const QPixmap *qpixmap = selectPixmap(name); 

82 if(qpixmap == NULL) { 

83 if(inf.isDir()) 

84 return (directoryPixmap); 

85 else 

86 retum(filePixmap); 

87 } 

88 retum(qpixmap); 

89} 

90 const QPixmap *MyIcons :: pixmap(const QUrllnfo &inf) 

91 { 

92 QString name = inf.name(); 

93 const QPixmap *qpixmap = selectPixmap(name); 

94 if(qpixmap == NULL) { 

95 if(inf.isDir()) 

96 return (directoryPixmap); 

97 else 

98 retum(filePixmap); 

99 } 

100 return (qpixmap); 

101 } 

102 const QPixmap *MyIcons: : selectPixmap(Q String &name) 

103 { 

104 if(name.right(4) == ”.cpp”) 

105 return (cppPixmap); 

106 if(name.right(2) == ，， .o") 

107 return (oPixmap); 

108 if(name.right(4) == ".png") 

109 return (pngPixmap); 

110 return (NULL); 

in} 

61 행에서 시작하는 구성자는 XPM 정보를 사용하여 픽스매프모임을 만들고 파일이름들 
과 련결한다 . 2 개 픽스매프는 5 행과 37 행에서 XPM 자료로 정의된다 . 이것들은 기정픽스매프 
들로서 특정한 픽스매프가 파일에 할당되지 않을 때마다 사용된다 . 



78 행과 90 행에서 선언된 pixmap() 이름의 2 가지 메쏘드는 파일과 련결하여 현시해야 할 
픽스매프를 결정하기 위하여 파일의 설명과 함께 호출된다 . 2 개 메쏘드는 꼭같은 일을 수행 
하지만 좀 다른 인수들을 받아들인다 . 81 행과 93 행에서 selectPixmapO 호출은 파일용픽스매프 
를 선택하는데 사용되지만 픽스매프는 selectPixmapO 로부터 얻지 않으면 두 기정픽스매프들 
중 하나가 선택된다 . 

102 행의 메쏘드 selectPixmapO 은 파일이름들을 시험하고 픽스매프가 할당되였는가를 결 
정한다 . 이 실례는 간단히 파일이름을 고찰하지만 검사는 파일형을 결정하기 위하여 파일에 
포함된 식별번호를 검사할수도 있다 . 

ShowFile 머 리 부파일 

1 /* showfile.h */ 

2 #ifiidef SHOWFILE_H 

3 #define SHOWFILE_H 

4 

5 #include <qwidget.h> 

6 #include <qlabel.h> 

7 #include <qstring.h> 

8 

9 class ShowFile: public QWidget 

10 { 

11 Q_OB JECT 

12 public: 

13 ShowFile(QWidget *parent=0,const char *name=0); 

14 private: 

15 QLabel *filelabel; 

16 QString filename; 

17 private slots: 

18 void popupOpen(); 



20 

21 #endif 
ShowFile 

1 /* showfile.cpp */ 

2 #include <kapplication.h> 

3 #include <qpushbutton.h> 

4 #include <qlayout.h> 
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5 #include <qfiledialog.h> 

6 #include "showfile.h" 

7 #include "myicons 上，， 

8 

9 int main(int argc,char **argv) 

10 { 

11 KApplication app(argc,argv, "showfile"); 

12 QFilelconProvider ^provider = new MyIcons(); 

13 QFileDialog: : setlconProvider(provider); 

14 ShowFile showfile; 

15 showfile. show(); 

16 app.setMainWidget(&showfile); 

17 return (app.exec()); 

18} 

19 ShowFile: :ShowFile(QWidget ^parent,const char *name) 

20 : QWidget(parent,name) 

21 { 

22 QPushButton ^button; 

23 QVBoxLayout *box = new QVBoxLayout(this,0,3 )； 

24 

25 filelabel = new QLabel(’"’,this); 

26 filelabel->setAlignment(Qt: : AlignHCenter); 

27 box->addWidget(filelabel); 

28 

29 button = new QPushButton("Select File to Open",this); 

30 box->addWidget(button); 

31 connect(button,SIGNAL(clicked()), 

32 this,SLOT(popupOpen())); 

33 

34 resize(10,10); 

35 box->activate(); 

36} 

37 void ShowFile: :popupOpen() 

38 { 

39 QString name = QFileDialog: : getOpenFileName( ,M, , 
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40 NULL,this); 

41 if(!name.isEmpty()) { 

42 filename = name; 

43 filelabel->setT ext (filename); 

44 } 

45} 

이 프로그람은 파일대화칸과 그림기호제공기를 련결하고 대화칸을 펼치는데 쓰이는 단 
추들을 제공한다 . 

그림기 호제공기 는 12 행 에서 창조된다 . 13 행의 정 적메쏘드 setIconProvider() 호출은 모든 
QFileDialog 객체에 대하여 그림 기호제공기로서 Mylcon 객체를 할당한다 . 이 기구는 기정 그림 
기호제공기를 새로운것으로 바꾼다 . 이 기술을 사용하여 자기가 좋아하는 많은 그림기호제 
공기 들을 가질수 있고 그것들을 변경할수 있다 . 

단추를 찰칵할 때마다 17 행의 처리부메쏘드 popupOpen() 가 호출된다 . QFileDialog 창문은 
39 행의 getOpenFilenameO 호출에 의해 펼쳐진다 . 41 행은 파일이름이 선택되였는가 결정하고 
선택되였으면 파일이름을 현시한다 . 


요 약 

이 장은 매우 특수한 도형조작에 대하여 설명하였다 . KDE 와 Qt API 의 부분으로 포함된 
수단들은 도형화상에 대한 조작을 가능하게 한다 . 

• 창문에 화소들을 그리는데 사용하는 API 는 인쇄폐지에 화소들을 그리는데도 사용할 
수 있다 . 

• 도형화상，또는 그 일부분을 만드는데 요구되는 단계별명령을 기억하고 임의의 회수 
재생할수 있다 . 

• 도형객체는 원래보다 더 크거나 작은 창문에 맞게 확대축소할수 있다 . 

• 도형객체에 대하여 비례확대축소，잘라내기，경사지기 , 변환 , 그리고 회전을 비롯한 
많은 조작을 수행할수 있다 . 

• 동화는 도형프레임들의 렬과 시계를 사용하여 만들수 있다 . 



제 14 장. 끌어다놓기 

학습내용 

응용프로그람안에 서 본문을 끌어 다놓기 
응용프로그람들중에 본문과 도형 의 끌어 다놓기 
체계오려둠판을 리용한 도형의 자르기와 붙이기 

표준자료전송능력 은 서 로 다른 두 응용프로그람들이 통합되 는것 처 럼 사용자에 게 보이 
도록 할수 있다 . 이 결합은 일반적으로 2 가지 방법으로 진행한다 . 마우스를 사용하여 한 창 
문에서 다른 창문에로 도형객체를 끌고감으로써 자료를 한 응용프로그람에서 다른 응용프로 
그람까지 이동시킬수 있다 . 다른 수법은 사용자가 체계오려둠판에 자료를 복사하고 다른 응 
용프로그람이 오려 둠판으로부터 자료를 읽어 들일수 있게 하는것 이 다 . 

끌어 다놓기 는 응용프로그람들사이 의 통신 에 매 우 쓸모있고 또한 하나의 응용프로그람 
에서 진행한 조작에도 아주 쓸모있다 . 사용자는 응용프로그람안에서 한 폼으로부터 다른 폼 
에로 객체를 이동할수 있고 혹은 하나의 창문안에서 객체들의 위치를 바꿀수 있다 . 

이 장은 끌어 다놓기 조작에서 발생 하는 사건들에 대 하여 설명한다 . 응용프로그람은 끌기 
조작이 요구되였다는것을 인식하고 자료를 끌기용으로 묶어야 하며 놓기목표는 놓기가 발생 
하였다는것을 인식하고 자료의 묶음을 열고 분배하여 야 한다 . 

제1절. 본문끌어다놀기 

다음 프로그람은 한 위치에서 다른 위치에로 본문의 끌어다놓기를 실현한다 . 임의의 창 
문부품도 끌기조작의 원천，놓기조작의 목표 , 또는 두가지로서 작용할수 있다 . 프로그람의 
끌기 와 놓기 조작들은 모두 원천과 목표창문부품들에 의해 직 접 조종된다 . 

DragDrop 머 리 부파 일 

1 /* dragdrop.h */ 

2 #ifndef DRAGDROP_H 

3 #defme DRAGDROP_H 

4 

5 #include <qwidget.h> 

6 #include <qstring.h> 

7 #include ’’dragfrom.h’’ 

8 #include "dropto.h" 

9 

10 class DragDrop: public QWidget 

11 { 

12 public: 
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13 DragDrop(QWidget *parent=0,const char *name=0); 

14 private: 

15 DragFrom *apples; 

16 DragFrom *oranges; 

17 DropTo *target; 

18}; 

19 

20 #endif 

15 행과 16 행에서 2 개 창문부품 apples 와 oranges 는 본문끌기조작의 원천으로서 동작하며 
창문부품 target 는 본문놓기조작의 목표로서 리용된다 . 

DragDrop 

1 /* dragdrop.cpp */ 

2 #include <kapplication.h> 

3 #include <qlayout.h> 

4 #include <qlabel.h> 

5 #include "dragdrop.h” 

6 

7 int main(int argc,char **argv) 

8 { 

9 KApplication app(argc,argv, M dragdrop M ); 

10 DragDrop dragdrop; 

11 dragdrop.show(); 

12 app.setMainWidget(&dragdrop); 

13 return (app.exec()); 

14} 

15 

16 DragDrop::DragDrop(QWidget *parent,const char *name) 

17 : QWidget(parent,name) 

18 { 

19 QVBoxLayout *box = new QVBoxLayout(this,30); 

20 box->addSpacing(30); 

21 

22 target = new DropTo( M target",this); 


23 box->addWidget(target); 

24 
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25 apples = new DragFrom( n apples",this); 

26 box->addWidget(apples); 

27 

28 oranges = new DragFrom("oranges M ,this); 

29 box->addWidget(oranges); 

30 

31 box->activate(); 

32} 

DragDrop 창문은 끌어다놓기가 가능한 3 개 창문부품의 기본창문이다 . 놓기조작의 목표는 22 행 
과 23 행에서 수직칸배치에 추가된다 . 2 개 본문끌기원천창문부품은 25~29 행에서 기본창문에 추가 
된다 . 그림 14-1 은 apples 창문부품의 본문을 목표에 끌어 다놓은 후에 창문을 보여준다 . 



그림 14 - 1 . 아래에서 우로 본문의 끌어다놓기 

DragFrom 머 리 부파 일 

1 /* dragfrom.h */ 

2 #ifndef DRAGFROM_H 

3 #defme DRAGFROM_H 

4 

5 #include <qlabel.h> 

6 #include <qstring.h> 

7 

8 class DragFrom: public QLabel 

9{ 

10 public: 
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11 DragFrom(const char *text,QWidget *parent=0); 

12 private: 

13 QString string; 

14 protected: 

15 virtual void mousePressEvent(QMouseEvent *); 

16}; 

17 

18 #endif 
DragFrom 

1 /* dragfrom.cpp */ 

2 #include <qlabel.h> 

3 #include <qfont.h> 

4 #include <qdragobject.h> 

5 #include "dragfrom.h” 

6 

7 DragFrom: : DragFrom(const char *text,QWidget ^parent) 

8 : QLabel(parent) 

9{ 

10 string = text; 

11 QString label("Source for "); 

12 label.append(text); 

13 setText(label); 

14 setAlignment(Qt: : AlignHCenter); 

15 QFont font("Courier", 18,QFont: :Bold,FALSE); 

16 setFont(font); 

17} 

18 void DragFrom::mousePressEvent(QMouseEvent *) 

19 { 

20 QDragObject *textdrag = new QTextDrag(string,this); 

21 textdrag->dragCopy(); 

22 } 

DragFrom 창문부품은 기초클라스로서 QLabel 창문부품을 사용한다 . 7 행에서 구성자에 제 
공된 본문은 10 행에서 문자렬에 보관되여 이 창문부품으로부터 끌수 있는 본문이며 한편 현 
시된 본문은 11 〜 13 행에서 “Source for” 에 의해서 선행된다 . 14 〜 16 행은 본문을 중심에 배치하 
고 서체를 지정 한다 . 






메쏘드 mousePressEvent() 는 마우스단추를 누를 때마다 호출되며 QTextDrag 객체는 20 행 
에서 만들어진다 . dragCopyO 호출은 QTextDrag 객체가 마우스에 따라 이동하게 한다 . 그 객체 
는 끌기 및 놓기조작(마우스단추를 놓을 때 그것이 목적지에 이르렀는가 아닌가：)에 의해 삭 
제되므로 자기 프로그람에서 그것을 삭제하지 말아야 한다 . 이 프로그람은 임의의 수의 
QTextDrag 객체들을 창조하고 보낼수 있지만 그것들중 어떤 객체의 마지막 처리에 대하여 절 
대로 통지되지 않는다 . 

DropTo 머리 부파일 

1 /* dropto.li */ 

2 #ifndefDROPTO_H 

3 #define DROPTO_H 

4 

5 #include <qlabel.h> 

6 #include <qevent.h> 

7 #include <qstring.h> 

8 

9 class DropTo: public QLabel 

10 { 

11 public: 

12 DropTo(const char *text,QWidget *parent=0); 

13 protected: 

14 void dragEnterEvent(QDragEnterEvent *e); 

15 void dropEvent(QDropEvent *e); 

16 }； 

17 

18 #endif 

메쏘드 dragEnterEvent() 와 dropEvent() 는 QWidget 기초클라스의 메쏘드선언들을 재정의한다 . 
이 메쏘드들은 끌어다놓기조작에서 마우스를 놓을 위치를 찾고 있을 때 호출된다 . 

DropTo 

1 /* dropto.cpp */ 

2 #include <qlabel.h> 

3 #include <qfont.h> 

4 #include <qdragobject.h> 

5 #include "dropto.h" 

6 

7 DropTo::DropTo(const char *text,QWidget *parent) 






: QLabel(text,parent) 


9{ 

10 setAlignment(Qt: : AlignHCenter); 

11 QFont font( M Courier M , 18,QFont: :Bold ? FALSE); 

12 setFont(font); 

13 setAcceptDrops(TRUE); 

14} 

15 void DropTo :: dragEnterEvent(QDragEnterEvent *e) 

16 { 

17 e->accept(QT extDrag: : canDecode(e)); 

18} 

19 void DropTo :: dropEvent(QDropEvent *e) 

20 { 

21 QString text; 

22 

23 if(QTextDrag: : decode(e,text)) 

24 setText(text); 

25} 

DropTo 클라스의 기초클라스는 QLabel 이며 거기에 놓는 본문을 현시한다 . 구성자중 10 
〜 12 행은 현시된 본문의 배치와 서체를 지정한다 . 

13 행의 setAcceptDrops() 호출은 마우스끌어다놓기조작의 목표로서 이 창문부품이 동작하 
게 한다 . 마우스가 끌기조작을 수행하고 있고 마우스지시기가 이 창문부품에 들어갈 때마다 
메쏘드 dragEnterEventO 는 끌고있는 자료에 대한 정보와 함께 호출된 다 . 또한 자료가 이 창 
문부품안에 떨어지면 dropEventO 가 호출된다 . 

15 행의 dragEnterEventO 는 마우스끌기가 이 창문부품의 경계에 들어갈 때마다 호출된다 . 
이 메쏘드의 목적은 창문부품이 놓기를 받아들이려고 하는가를 판단하는것이다 . 이 실례는 
간단히 끌고있는 자료를 본문으로 변환할수 있는가를 판단하기 위하여 QTextDrag 클라스의 
정적 canDecode() 메쏘드를 호출한다 . 만일 변환할수 있다면 TRUE 인수와 함께 accept() 호출이 
이루어지고 그렇지 않으면 FALSE 인수와 함께 호출된다 . 

19 행의 메쏘드 dropEventO 는 일정한 사건 렬 이 발생하면 호출된다 . 마우스의 끌어 다놓기 
조작이 있고 이 창문부품에 들어갔으며 dragEnterEventO 메쏘드가 사건의 accept() 메 쏘드를 
TRUE 를 가지고 호출하였으면 dropEventO 메쏘드가 호출된다 . 이 실례는 본문을 받아들이고 
23 행은 QTextDrag 클라스의 정적 decode() 메쏘드호출을 만들며 결과복호화된 본문이 표식자의 
본문설 정 에 사용되 고 끌어 다놓기 조작은 성 공적 으로 완료된 다 . 



제 2 절. 본문과 화상자료의 끌어다놀기 

다음 2 개 프로그람은 한 응용프로그람에서 다른 응용프로그람에로 객체들을 끌고가는 
방법과 받아들이는 프로그람이 놓은 자료의 형을 판단하는 능력을 보여준다 .2 개의 끌기원천 
즉 본문과 화상원천이 있으나 오직 하나의 놓기목표가 있다 . 놓기목표는 들어오는 자료형을 
판단하고 그에 따라 작용한다 . 

Datelmage 머 리 부파일 

1 /* dateimage.h */ 

2 #ifndef DATEIMAGE_H 

3 #define DATEIMAGE_H 

4 

5 #include <qwidget.h> 

6 #include <qlabel.h> 

7 #include <qdragobject.h> 

8 

9 class Datelmage: public QWidget 

10 { 

11 public: 

12 DateImage(QWidget *parent=0,const char *name=0); 

13 }； 

14 

15 class DateSource: public QLabel 

16 { 

17 public: 

18 DateSource(QWidget *parent=0); 

19 protected: 

20 virtual void mousePressEvent(QMouseEvent *); 

21}； 

22 

23 class ImageSource: public QLabel 

24 { 

25 public: 

26 ImageSource(QWidget *parent=0); 

27 protected: 

28 virtual void mousePressEvent(QMouseEvent *); 







29}; 

30 

31 #endif 

이 머리부파일은 끌고있는 자료의 원천인 클라스들의 선언을 포함한다 . Datelmage 클라 
스는 현시 될 때 DateSource 객체 와 ImageSource 객체 모두를 포함하는 제 일웃준위 창문이 다 . 
DateSource 와 ImageSource 클라스는 모두 QLabel 의 파생클라스이므로 그것들은 모두 본문을 
현시하고 끌어다놓기조작의 원천으로 사용될수 있다 . DateSource 로부터 끌기되는 자료는 본 
문문자렬이고 ImageSource 로부터 끌기되는 자료는 Qlmage 객체이다 . 

Datelmage 

1 /* dateimage.cpp */ 

2 #include <kapplication.h> 

3 #include <qlayout.h> 

4 #include <qlabel.h> 

5 #include <qfont.h> 

6 #include <time.h> 

7 #include "dateimage.h" 

8 

9 #include "bluemarble.xpm" 

10 

11 int main(int argc,char **argv) 

12 { 

13 KApplication app(argc,argv, "dateimage"); 

14 Datelmage dateimage; 

15 dateimage. show(); 

16 app.setMainWidget(&dateimage); 

17 return (app.exec()); 

18 } 

19 

20 Datelmage::DateImage(QWidget ^parent,const char *name) 

21 : QWidget(parent,name) 

22 { 

23 QVBoxLayout *box = new QVBoxLayout(this,30); 

24 

25 DateSource *ds = new DateSource(this); 
box->addWidget(ds); 


26 
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27 

28 ImageSource *is = new ImageSource(this); 

29 box->addWidget(is); 

30 

31 box->activate(); 

32} 

33 

34 DateSource: : DateSource(QWidget ^parent) 

35 : QLabel("Date M ,parent) 

36 { 

37 setAlignment(Qt: : AlignHCenter); 

38 QFont font( M Courier n , 18,QFont: :Bold,FALSE); 

39 setFont(font); 

40} 

41 void DateSource: :mousePressEvent(QMouseEvent *) 

42 { 

43 time_t t; 

44 char *ct; 

45 

46 t = time((time_t *)0); 

47 ct = ctime(&t); 

48 QString string(ct); 

49 QDragObject *textdrag = new QTextDrag(string,this); 

50 textdrag->dragCopy(); 

51} 

52 

53 

54 ImageSource::ImageSource(QWidget ^parent) 

55 : QLabel( M Image M ,parent) 

56 { 

57 setAlignment(Qt: : AlignHCenter); 

58 QFont font( M Courier M , 18,QFont: :Bold,FALSE); 

59 setFont(font); 

60} 

61 void ImageSource :: mousePressEvent(QMouseEvent *) 
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62 { 

63 Qlmage image(magick); 

64 QDragObject *imagedrag = new QImageDrag(image,this); 

65 imagedrag->dragCopy(); 

66 } 

20 행의 Datelmage 구성자는 수직 칸을 사용하여 DateSource 객체와 ImageSource 객체를 포함 
한다 . DateSource 와 ImageSource 는 모두 기초클라스로서 QLabel 을 사용하며 그림 14-2 에서 보 
여준것과 갈은 창문을 만든다 . 



그림 14-2. 본문과 화상끌기조작의 원천 

34 행의 DateSource 구성자는 그 자체의 서체와 본문배치를 설정한다 . 35 행에서 QLabel 기 
초클라스의 초기화는 현시본문으로서 ’’Date" 를 지정한다 . 41 행의 mousePressEvent() 는 현재체 
계시간을 포함하는 문자렬을 만들고 그것을 리용하여 49 행에서 QTextDrag 객체를 구성한다 . 
50 행의 dragCopyO 호출은 QTextDrag 객체를 마우스에 련결하고 그것을 그 방향으로 보낸다 . 

54 행의 ImageSource 구성자는 그 자체의 서체와 본문배치를 설정한다 . 55 행의 QLabel 기초 
클라스초기화는 현시본문으로서 ’’Image’’ 를 지정한다 . 61 행의 mousePressEventO 는 9 행에서 포 
함한 XPM 자료로부터 Qlmage 객체를 만든다 . Qlmage 객체는 64 행에서 QlmageDrag 객체의 창조 
에 사용된다 .65 행의 dragCopyO 호출은 QlmageDmg 객체를 끌수 있도륵 마우스에 련결한다 . 
Target 머 리 부파 일 

1 /* target.h */ 

2 #ifndefTARGET_H 

3 #defme TARGET—H 


5 #include <qwidget.h> 

6 #include ’’target.h” 


8 class Target: public QWidget 
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9{ 

10 public: 

11 Target(QWidget *parent=0,const char *name=0); 

12 protected: 

13 void dragEnterEvent(QDragEnterEvent *e); 

14 void dropEvent(QDropEvent *e); 

15 }； 

16 

17 #endif 

놓기목표는 창문부품의 제 일웃준위창문이 다 . 이 것을 달성하기 위하여 QWidget 가상메쏘 
드 dragEnterEvent () 와 dropEvent () 를 재 정 의 해 야 한다 . 

Target 

1 /* target.cpp */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include <qdragobject.h> 

5 #include ’’target.h’’ 

6 

7 int main(int argc’char **argv) 

8{ 

9 KApplication app(argc,argv, "target"); 

10 Target target; 

11 target.show(); 

12 app. setMainWidget(&target); 

13 return (app.exec()); 

14} 

15 

16 Target: : Target(QWidget *parent,const char *name) 

17 : QWidget(parent,name) 

18 { 

19 setFixedSize(400,300); 

20 setAcceptDrops(TRUE); 

21 } 

22 void Target::dragEnterEvent(QDragEnterEvent *e) 

23 { 


371 






24 e->accept(QTextDrag :: canDecode(e) 11 

25 QlmageDrag: :canDecode(e)); 

26} 

27 void Target: : dropEvent(QDropEvent *e) 

28 { 

29 QString text; 

30 Qlmage image; 

31 

32 if(QTextDrag::decode(e ， text)) { 

33 drawT ext(e->pos(),text); 

34 } 

35 if(QImageDrag::decode(e,image)) { 

36 QPainter *p = new QPainter(this); 

37 p->drawImage(e->pos(),image); 

38 } 

39} 

16 행의 구성자는 기본창문의 크기를 고정시키고 setAcceptDropsO 를 호출하여 이 창문을 
놓기 목표로서 가능하게 한다 . 

22 행의 dragEnterEvent () 는 끌기하는 마우스가 이 창문의 경계에 들어갈 때마다 호출된다 . 끌 
고있는 자료형을 창문이 받아들일수 있으면 QDragEnterEvent 객체의 accept () 메쏘드에 TOUE 를 넘 
기여 호출하고 그렇지 않으면 FALSE 로 호출한다 . 이 창문은 본문과 화상자료 모두 받아들일수 
있으므로 이것들중 어느것이나 복호화할수 있을 때 TRUE 로 된다 . 

마우스로 이 창문부품우에 자료를 놓으면 27 행에서 dropEventO 가 호출된다 . 32 행에서 
QTextDrag 의 decode () 호출은 자료를 얻으러고 한다 . 복호화가 성공하면 자료는 본문에 기억 
되고 33 행의 drawText () 호출은 창문에 본문을 그린다 . 국부창문에서 본문의 정확한 위치는 
마우스지시자를 놓는 위치에 의해 결정되며 그 위치는 QDropEvent 객체의 pos () 호출로부터 
QPoint 객체로서 얻는다 . 복호화절차는 QlmageDrag 클라스의 decodeO 메쏘드를 호출함으로써 
반복된다 . 화상이 성공적으로 복호화되면 QPainter 객체는 놓기위치에서 창문에 화상을 그리 
는데 사용된다 . 그림 14-3 에서는 몇개의 본문과 화상을 놓은 후에 목표창문을 보여준다 . 





그림 14-3. 갈은 창문에 놓인 본문과 화상자료 
2 가지 다른 방법은 특별한 도형을 현시하려고 하는 경우에 놓기목표창문부품에 의해 
마음대로 사용될수 있다 . 다음 메 쏘드는 끌고있는 마우스가 아무것도 놓지 않고 창문을 떠 
날 때마다 호출된다 . 

void Target: :dragExitEvent(QDragExitEvent *e) 

이 메쏘드를 리용하여 사용자에게 더 많은 반결합을 제공할수 있다 . 실례로 이 메쏘드 
는 dragEiiterEventO 와 결합하여 끌고있는 마우스가 창문우로 날아다닐 때마다 목표창문부품 
을 강조한다 . 이것은 몇가지 작은 목표창문들이 서로 옆에 있을 때 리용할수 있다 . 마우스가 
목표창문안에서 위치를 바꿀 때마다 호출되는 다음의 메쏘드를 리용하여 가능한 놓기위치를 
추적할수 있다 . 

void Target :: dragMoveEvent(QDragMoveEvent *e) 

이 메쏘드를 사용하는 하나의 실례는 +기호 혹은 다른 지시기를 가능한 놓기위치에 배 
치 하는것 이 다 . 


제3절. 자르기와 붙이기 

끌어다놓기에 사용한것과 같은 기초기구를 자르기와 붙이기에 사용할수 있다 . 객체를 
한 응용프로그람에 서 다른 응용프로그람에 로 끌기 하는것 은 그것 을 오려 둠판에 복사하는것 과 
같은데 차이 나는것 은 대 면 부가 바뀐 다는것 이 다 . 

다음 프로그람은 자르기，복사 및 붙이기조작을 리용하여 그자체와 오려둠판사이에서 
이동할수 있다 . 그림 14-4 에서는 KDE 오려둠판과 프로그람사이에서 두방향으로 픽스매프를 
전송하는데 사용하는 창문과 단추들을 보여준다 . 






그림 14-4. KDE 오려 둠판과 프로그람사이 에 서 량방향으로 화상의 복사 
CutPaste 머 리 부파일 

1 /* cutpaste.h */ 

2 #ifndef CUTPASTE_H 

3 #defme CUTPASTE_H 

4 

5 #include <qwidget.h> 

6 #include <qpixmap.h> 

7 

8 class CutPaste: public QWidget 

9{ 

10 Q_OBJECT 

11 public: 

12 CutPaste(QWidget *parent=0,const char *name=0); 

13 private: 

14 QWidget *widget; 

15 QPixmap *pixmap; 

16 private slots: 

17 void loadButton(); 

18 void copyButton(); 
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19 void cutButton(); 

20 void pasteButton(); 

21 }； 

22 

23 #endif 

14 행의 QWidget 는 QPixmap 를 현시하는데 사용된다 . 15 행의 QPixmap 는 현재 현시되는 
화상이 다 .4 가지 처 리 부메 쏘드는 누름단추들에 응답하는것 들이 다 . 

CutPaste 

1 /* cutpaste.cpp */ 

2 #include <kapplication.h> 

3 #include <qlayout.h> 

4 #include <qimage.h> 

5 #include <qdragobject.h> 

6 #include <qclipboard.h> 

7 #include <qpushbutton.h> 

8 #include ’’cutpaste.h” 

9 

10 int main(int argc,char **argv) 

11 { 

12 KApplication app(argc,argv, ’’cutpaste’’); 

13 CutPaste *cutpaste = new CutPaste(); 

14 cutpaste->show(); 

15 app. setMainWidget(cutpaste); 

16 return (app.exec()); 

17} 

18 

19 CutPaste::CutPaste(QWidget *parent,const char *name) 

20 : QWidget(parent,name) 

21 { 

22 QPushButton ^button; 

23 QHBoxLayout *hlayout = new QHBoxLayout(this,5); 

24 QVBoxLayout *vlayout = new QVBoxLayout(); 

25 

26 pixmap = NULL; 


27 
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28 button = new QPushButton("Load n ,this); 

29 connect(button,SIGNAL(clicked()), 

30 this,SLOT(loadButton())); 

31 vlayout->addWidget(button); 

32 

33 button = new QPushButton("Copy M ,this); 

34 connect(button,SIGNAL(clicked()), 

35 this,SLOT(copyButton())); 

36 vlayout->addWidget(button); 

37 

38 button = new QPushButton("Cut n ,this); 

39 connect(button,SIGNAL(clicked()), 

40 this,SLOT(cutButton())); 

41 vlayout->addWidget(button); 

42 

43 button = new QPushButton( M Paste M ,this); 

44 connect(button,SIGNAL(clicked()), 

45 this,SLOT(pasteButton())); 

46 vlayout->addWidget(button); 

47 

48 widget = new QWidget(this); 

49 widget->setFixedSize(257,303); 

50 widget->setBackgroundColor(QColor( M white M )); 

51 

52 hlayout->addWidget(widget); 

53 hlayout->addLayout(vlayout); 

54 

55 resize(10,10); 

56 hlayout->activate(); 

57} 

58 void CutPaste: :loadButton() 

59 { 

60 if(pixmap != NULL) 

61 delete pixmap; 

62 pixmap = new QPixmap("logo.xpm n ); 




63 widget->setBackgroundPixmap(*pixmap); 

64} 

65 void CutPaste: :copyButton() 

66 { 

67 if(pixmap !=NULL) { 

68 Qlmage image = pixmap->convertToImage(); 

69 QDragObject *drag = new QImageDrag(image,this); 

70 QClipboard ^clipboard = QApplication: :clipboard(); 

71 clipboard->setData(drag); 

72 } 

73} 

74 void CutPaste: : cutButton() 

75 { 

76 if(pixmap != NULL) { 

77 copyButton(); 

78 widget->setBackgroundColor(QColor("white M )); 

79 delete pixmap; 

80 pixmap = NULL; 

81 } 

82} 

83 void CutPaste: : pasteButton() 

84 { 

85 QClipboard ^clipboard = QApplication: : clipboard。; 

86 QMimeSource *mime = clipboard->data(); 

87 Qlmage image; 

88 if(QImageDrag::decode(mime,image)) { 

89 QPixmap *newPixmap = new QPixmap(); 

90 if(newPixmap->convertFromImage(image)) { 

91 if(pixmap !=NULL) 

92 delete pixmap; 

93 pixmap = newPixmap; 

94 widget->setBackgroundPixmap(*pixmap); 

95 } 

96 } 


97 } 
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19 행에서 시작하는 구성자는 자료를 초기화하고 수직칸에 단추모임을 삽입하여 현시하며 
수평칸에 수직칸과 창문부품을 삽입한다 . 초기픽스매프는 현시되지 않으므로 26 행에서 NULL 
로 초기 화된다 . 도형 현시 창문부품은 48 행 에서 만들어 지 고 고정 백 색 배경 으로 초기 화된다 . 

58 행의 처리부메쏘드 loadButton() 은 파일로부터 새로운 픽스매프를 적재한다 . 60 행과 61 
행은 이전에 존재하는 픽스매프를 삭제하고 M 행의 setBackgroundPixmapO 호출은 새로 적재 
한 픽 스매 프를 현 시한다 . 

65 행의 처리부메쏘드 copyButton() 은 픽스매프가 존재하는가 검사하고 존재하면 그것을 
오려둠판에 복사한다 . 68 행의 convertToImage() 호출은 픽스매프를 Qlmage 로 변환한다 . 왜냐하면 
그것이 QlmageDrag 에 요구되는 도형이 기때문이다 . (^Clipboard 객체의 주소는 70 행에서 
clipboardO 메쏘드호출에 의해 엄고 자료는 기행에서 setData() 호출에 의해 오려둠판에 보관된다 . 

74 행의 처리부메쏘드 cutButton() 는 픽스매프가 존재하는가 검사하고 존재하면 그것을 
오려둠판에 복사하고 그것을 국부적으로 삭제한다 . copyButton() 호출은 오려둠판에 픽스매프 
를 복사한다 . setBackgroundColorO 호출은 창문으로부터 픽스매프를 지우고 79 행과 80 행은 기 
억기로부터 픽스매프를 삭제한다 . 

83 행의 처 리부메쏘드 pasteButtonO 는 오려둠판에서 이 응용프로그람에로 픽스매프를 읽 
어들인다 . 85 행에서 정적메쏘드 clipboardO 호출은 체계오려둠판의 주소를 얻는다 . 오려둠판은 
자료를 QMineSource 객체로 보관하며 이 것은 86 행의 data() 호출에 의 해 얻 어 진다 . 몇 가지 다 
른 자료형 들을 오려 둠판에 기 억할수 있으므로 88 행 에 서 decodeO 호출로부터 돌아오는 
Boolean 돌림값은 자료가 성 공적 으로 Qlmage 객 체로 변환되 였는가 검 사되 여 야 한다 . 변환이 
성공하면 90 행의 convertFromlmageO 호출은 자료로부터 픽스매프를 창조하며 91 〜 94 행은 현 
존픽스매프를 새로운것과 교체하고 그것을 새 현시배경으로서 창문부품에 보관한다 . 

요 약 

한 위치에서 다른 위치에로 자료를 끌고가는것，또는 한 위치에서 자료를 자르고 다른 
위치에 그것을 붙일 때 송신자와 수신자 모두가 자료형과 그것을 묶는 방법을 일치시킬것을 
요구한다 . 응용프로그람의 견지로부터 자료전송과 수신은 함수호출보다 훨씬 더 쉽다 . 이 장 
은 다음과 같은 자료의 끌어다놓기에 대하여 설명하였다 . 

• 다른 장소로 자료를 끌고가려면 우선 QDragObject 에 그것을 일봉해야 한다 . 창문이 
떨구어놓은 객체를 받아들이 려 면 QDragObject 의 자료를 복호화할 준비가 되 여있어 야 한다 . 

• setAcceptDropsO 는 떨구어놓은 자료를 창문부품이 받아들이 기전에 호출되 여 야 한다 . 

• 자르기 와 붙이기 조작은 체 계 QClipboard 객 체 가 자료보관에 매 개 물로 사용되 는것 외 에는 
끌어다놓기와 본질적으로 갈다 . 

다음 장은 애 플레 프를 론의한다 . 애 플레 트는 KDE 환경 에 서 기 본창문의 밑 (또는 다른 
변)에 있는 구획에 나타나는 작은 그림기호부류의 창문이다 . 또한 한 응용프로그람에서 다른 
응용프로그람에로 자료를 보내는 다른 방법들을 론의한다 . 
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제 15 장. 프로쎄스사이 통신과 매플레트 

학습내용 

지령행에 인수넘기기 

한 실 행 프로그람으로부터 다른 실 행 프로그람에 로 자료블로크송신 
파넬에서 애플레트를 통한 사용자호출의 제공 
오직 프로쎄스의 한개 실례만 임의의 시간에 실행한다는것의 담보 
한 프로그람으로부터 다른 프로그람에로 자료를 넘기는데는 2 가지 기본방법 이 있다 . 기 
동할 때 인수들을 지 령행에 줄수 있고 실행시 에 자료블로크가 한 응용프로그람에 의해 생성 
되여 그것을 기다리고있는 다른 프로쎄스에 넘어갈수 있다 . KDE 는 이 두가지 통신방법을 모 
두 제공한다 . 

지 령행으로부터 오는 정 보를 분석하고 보관하는 지 령행클라스가 있다 . 그밖에도 어 느 
정도 응용프로그람에서 사용할수 있는 환경을 표준화하는 KDE 선택기발들에 대한 호출을 제 
공한다 . 즉 이 객체를 사용함으로써 다른 응용프로그람들은 표준모임의 기발들에 표준방법 
으로 응답하도록 프로그람을 작성할수 있다 . 

프로쎄스사이 통신모형 은 통보문들을 조종하기 위 하여 배경 에서 실행하는 봉사기 를 요 
구한다 . 이 봉사기는 우편국과 같은 기능을 수행한다 . 매개 응용프로그람은 이름에 의해 식 
별되는 P.O. ( 우편국)칸을 엄으며 다른 응용프로그람들은 거기에 통보문들을 보관할수 있다 . 

애플레트는 기본 KDE 창문의 한쪽에 존재하는 KDE 조종판 (KDE kicker ) 에 그림기호로서 
창문을 현시 하는 특수한 응용프로그람이 다 . 애 플레 트는 그 제 일 웃준위창문으로서 매 우 작은 
창문을 가지는 결함을 가지고 있으나 항상 사용자가 볼수 있는 우점이 있다 . 

이 장은 자기 프로그람이 이 자료교환방법과 애플레트의 우점을 리용하는 여러가지 방 
법 을 설 명한다 . 


제1절. DCOP 통신모형 

탁상통신 규약 (DCOP, Desktop Communications Protocol ) 쏘프트웨 어 는 프로쎄 스의 그룹 안 
에서 프로쎄스사이통신을 설정하는 매우 간단한 방법을 제공하기 위하여 개발되였다 . 데몬 
프로쎄스를 통한 모든 통신을 dcop 봉사기라고 부론다 . 통보문을 송신 혹은 수신하려는 한개 
프로쎄 스는 우선 dcopserver 로서 이름을 등록하고 다른 프로쎄 스는 dcopserver 의 보호하에 그 
이름에 통보문들을 보낼수 있다 . 

DCOP 는 실제로 RPC ( 원격수속호출)기계의 간단한 형식이다 . 통보문은 인수를 요구하거 
나 요구하지 않으며 돌림값을 주거나 주지 않을수 있는 함수호출형식으로 송신된다 . 

다음 실례는 3 개의 프로그람으로 이루어진다 . wilbur 프로그람은 자기를 dcopserver 로 등 
록하고 통보문이 도착하기를 기다린다 . 프로그람 tellwilbur 는 wilbur 에게 통보문을 송신하고 
응답을 기다리지 않지만 askwilbur 는 통보문을 보내고 응답을 기다린다 . 
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Wilbur 머 리 부파일 
1 /* wilbur.h */ 


2 #ifiidefWILBUR_H 

3 #define WILBUR_H 

4 

5 #include <qmultilineedit.h> 

6 #include <dcopobject.h> 

7 

8 class WilReceiver: public QMultiLineEdit, public DCOPObject 

9{ 

10 public: 

11 WilReceiver(const char *name=0); 

12 bool process(const QCString &function, 

13 const QByteArray &data,QCString &replyType, 

14 QByteArray &replyData); 

15 double cubeRoot(double value); 

16 private: 

17 }； 

18 

19 #endif 

WilReceiver 는 DCOPObject 이므로 그것은 통보문들을 받아들이 고 국부수속을 실행하고 
통보문의 발신자에게 결과를 되돌려줄수 있다 . 또한 QMultiLineEdit 창문부품을 계승하므로 
WilReceiver 는 창문부품이 다 . 

12 행 에서 DCOPObject 클라스의 순수가상메쏘드 process 。 를 재정의한다 . 그것은 통보문을 
다른 메쏘드로부터 받아들일 때마다 호출된다 . 15 행의 메쏘드 cubeRoot () 는 다른 메쏘드로부 
터 호출될수 있다 . 

Wilbur 

1 /* wilbur.cpp */ 

2 #include <kapplication.h> 

3 #include <qcstring.h> 

4 #include <qmultilineedit.h> 

5 #include <dcopclient.h> 

6 #include <math.h> 

7 include "wilbur.h" 
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9 int main(int argc,char **argv) 

10 { 

11 QString str; 

12 KApplication app(argc,argv, "wilbur"); 

13 

14 DCOPClient *client = app.dcopClient(); 

15 QCString dcopID = client->registerAs(app.name(), FALSE); 

16 

17 WilReceiver *wilbur = new WilReceiver( n wilreceiver M ); 

18 app. setMainW idget (wilbur); 

19 

20 str.sprintfC'wilbur registered as \"%s \""， 

21 dcopID.data()); 

22 wilbur->insertLine(str); 

23 

24 int retumValue = app.exec(); 

25 client->detach(); 

26 return (retumValue); 

27} 

28 WilReceiver: : WilReceiver(const char *name) 

29 : DCOPObj ect(name) 

30 { 

31 setReadOnly(TRUE); 

32 show(); 

33} 

34 bool WilReceiver :: process(const QCString &function, 

35 const QByteArray &data, 

36 QCString &replyType, 

37 QByteArray &replyData) 

38 { 

39 if(function = "cubeRoot(double)") { 

40 double inValue; 

41 double outvalue; 

42 QDataStream inStream(data,IO_ReadOnly); 
inStream »inValue; 


43 
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44 outvalue = cubeRoot(inV alue); 

45 QDataStreamoutStream(replyData,IO_WriteOnly); 

46 outStream « outvalue; 

47 replyType = "double"; 

48 return (TRUE); 

49 } else { 

50 QString string; 

51 string.sprintf("call to unknown function %s", 

52 function.data()); 

53 insertLine(string); 

54 return (FALSE); 

55 } 

56} 

57 double WilReceiver: : cubeRoot(double value) 

58 { 

59 QString string; 

60 double root = cbrt(value); 

61 string.sprintf("Cube root of %g is %g",value,root); 

62 insertLine(string); 

63 return (root); 

64} 

이 프로그람은 제 일웃준위창문부품으로서 WilReceiver 객체를 사용한다 . 이 것은 본문을 
현시하며 들어오는 통보문들에 응답할 능력에 있다 . 

dcopserver 를 통하여 통신하는 모든 프로쎄스는 의뢰기로 등록되여야 한다 . 14 행의 
dcopClient() 호출은 국부 DCOPClient 객체를 만들고 그 주소를 돌려 준다 . 15 행의 registerAs() 호출 
은 dcopserver 데몬과 의뢰기의 이름을 등록한다 . 12 행에서 지정한 응용프로그람의 이름은 
"Wilbur" 이므로 지금까지 "wilbur” 에 보내온 통보문은 이 프로그람에 되돌아온다 . 실제 등록 
이름은 15 행의 dcopID 안의 문자별로서 보관된 돌림값이다 . 

두 프로쎄스들은 같은 이름으로 등록될수 없으므로 dcopserver 는 충돌을 발견하고 등록 
이름을 수정한다 . 첫째 충돌은 ’’wilbur-2" 인 등록이름에서 발생하고 다음에는 "wilbur-3" 에서 
생긴다 . 또한 registerAs() 의 둘째 인수로서 TRUE 를 사용하여 프로쎄스식별번호가 이름의 부 
분으로 추가되게 함으로써 유일한 등록이름을 생성하도록 한다 . 례를 들면 실례 wilbur 의 프 
로쎄스 ID 가 34212 이라면 등록이름은 ’’wilbur-34212’’ 이다 . 이것은 항상 유일한 등록이름을 생 
성하도록 한다 . 

제일웃준위창문부품은 17 행과 18 행에서 설정된다 . 창문부품에 할당된 이름은 ’’wilreceiver" 이 
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다 . 그것이 하나이상의 DCOPObject 를 하나의 프로쎄스에 포함하는데 쓰이고 그 매개는 통보문 
들을 받아들이는데 쓰일수 있으므로 매개에 이름을 제공하여야 한다 . 

20 〜 22 행 은 DCOPClient 의 등록이 름을 현시한다 . 

GUI 응용프로그람의 기 본순환고리 는 24 행의 exec() 호출에 의해 실행된다 . 25 행의 detach() 
호출은 dcopserver 로부터 등록을 삭제하기 위 한것 이 다 . 이 것은 프로쎄스가 실행을 멈 출 때마 
다 등록이 자동적으로 삭제되므로 반드시 필요한것은 아니다 . 

28 행의 WilReceiver 구성자는 QMultiLineEdit 창문을 읽기전용으로 설정하며 이것은 편집 
할수 없는 본문을 현시한다는것을 보여준다 . 

34 행의 processor dcopserver 로부터 통보문이 도착할 때마다 호출된다 . 메쏘드에 4 개 인 
수가 있다 . 

const QCString function 호출하려 는 수속의 이 름과 인수형 들 

constQByteArray&data 호출한 수속에 넘기려는 인수들 

QCString &replyType 수속으로부터 돌아오는 값의 자료형 

QByteArray &replyData 돌림 값 . 

39 행의 if 명령문은 함수와 자료형이 허용되는가 확인한다 . 많은 국부수속을 사용할수 있 
다 . 어 느것을 호출하는가 결정하기 위한 시 험을 추가할 필요가 있다 . 

알아두기 : 용어에서 원격수속호출과 조금 삭갈리기 쉽다 . 원격프로쎄스는 함수나 메쏘 
드인 cubeRoot(double) 라는 이름의 수속호출을 요구한다 . 혹은 그것은 간단히 inline 실 
행일수 있으며 심지 어 완전히 다른 언어로 실현된다 . 대면부가 갈으면 결과는 얻어지 
고 실제프로쎄스의 세부는 중요하지 않다 . 

수속에 넘기려는 인수 ( 들)은 QByteArray 에 보관되여 도착하므로 실제값을 꺼내기 위하 
여 42 행에서 창조된 QDataStream 을 사용하는것이 필요하다 . 이 실례에는 1 개 인수만 있고 
그것은 43 행에서 inValue 에 얻는다 . 메쏘드 cubeRootO 는 outvalue 에 보관된 결과들과 함께 44 
행에서 호출된다 . 돌림값은 45 행에서 창조된 출력흐름을 사용하여 46 행의 replyData 에 보관 
된다 . 돌림 값의 자료형 은 47 행의 replyType 에 보관된다 . 돌림 값이 TRUE 이 면 성공을 의미한 
다 . 

알아두기 : 통보문에 응답하는데 필요된 코드가 좀 서틀어 보이 는데 이 것은 자동생성 용 
으로 설계되였기때문이다 . 이 전체 과정은 콤파일러에 의해 자동생성된 processO 메쏘 
드의 내용에 기초하는 프로젝트가 있으므로 가까운 앞날에 모두 간단화되여야 하며 
이것은 MOC 콤파일러가 신호와 처리부용 코드를 생성하는것과 아주 류사하다 .. 

57 행의 cubeRootO 메쏘드는 double 값을 받아들이 고 그 3 제급뿌리를 돌려 준다 . 또한 들어 
오는 수，그리 고 그 뿌리 를 창문의 본문행 으로서 현시한다 . 이 메 쏘드는 원격 으로 호출되 지 
만 그것은 보통 메쏘드이고 국부적으로 호출될수 있다 . 

TellWilbur 

1 /* tellwilbur.cpp */ 
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2 #include <kapplication.h> 

3 #include <qcstring.h> 

4 #include <dcopclient.h> 


5 

6 int main(int argc,char **argv) 

V{ 

8 KApplication app(argc,argv, "tellwilbur"); 

9 

10 DCOPClient *client = app.dcopClient(); 

11 QCString dcopID = client->registerAs(app.name()); 

12 

13 QByteArray params; 

14 QDataStream stream(params,IO_WriteOnly); 

15 stream « (double)999.0; 

16 if(!client- 〉 send("wilbur","wilreceiver", 

17 "cubeRoot(double)",params)) { 

18 qDebugC'Well, that didn’t work!"); 

19 } 

20 

21 client->detach(); 

22 return (0); 

23} 

이 프로그람은 wilbur 에게 통보문을 보내며 응답을 기다리지 않는다 . 

DCOP 을 사용하여 통신하려면 dcopserver 에 등록하여야 한다 . 이것은 KApplication 객체를 
만들고 그것을 리용하여 국부 DCOPClient 의 주소를 얻은 다음 이 응용프로그람의 이름을 가 
지 고 registerAsO 를 호출한다는것 을 의 미한다 . 

인수들을 QByteArray 에 넣어보내므로 14 행에서 QDataStream 객체를 창조하고 15 행에서 
거기에 double 인수를 보관한다 . 16 행의 send{} 호출은 통보문을 보내지만 응답을 기다리지 않 
는다 . 첫째 인수는 ’’wilbur’’ 이다 . 이것은 통보문을 받아들이려는 응용프로그람의 등록이름이 
다 . 둘째 인수는 "wilreceiver" 이다 . 이것은 응용프로그람내부에 있는 DCOPObject 의 이름이다 . 
호출하려 는 수속은 ’’cubeRootCdoublef 이 라고 이 름지 어 진 다 . 마지 막 인 수 (params) 는 수속에 넘 
기려는 인수값들을 포함한다 . 

알아두기 : 이미 설명한것처 럼 등록이 름은 ’’wilbur-29003 ’’과 같이 거기 에 추가된 번호를 
가질수 있다 . 실제이 름을 찾으러 면 응용프로그람이 DCOPClient 클라스의 

registeredApplications() 를 호출해 야 한다 . 이 메 쏘드는 등록된 이 름들을 모두 포함한 
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QCS 仕 ingList 객체를 돌려주며 응용프로그람은 여기서 필요한 이름 ( 이름들)을 탐색할수 
있다 . 

sendO 메 쏘드는 응답을 기 다리 지 않으므로 돌림값은 없다 . 21 행의 detachO 호출은 
dcopserver 로부터 등록을 삭제 한다 . 

AskWilbur 

1 /* askwilbur.cpp */ 

2 #include <kapplication.h> 

3 #include <qcstring.h> 

4 #include <dcopclient.h> 

5 

6 int main(int argc’char **argv) 

V{ 

8 KApplication app(argc,argv, "askwilbur"); 

9 

10 DCOPClient *client = app.dcopClient(); 

11 QCString dcopID = client->registerAs(app.name()); 

12 

13 QByteArray params; 

14 QByteArray reply; 

15 QCString replyType; 

16 QDataStream stream(params,IO_WriteOnly); 

17 stream « (double)888.0; 

18 if(!client->call( M wilbur ,, ； 'wilreceiver", 

19 "cubeRoot(double) ",params, 

20 replyType,reply)) { 

21 qDebugC'Well, that didn’t work!"); 

22 } else { 

23 QDataStream inStream(reply,IO_ReadOnly); 

24 if(replyType = "double") { 

25 double root; 

26 inStream » root; 

27 QString str; 

28 str.sprintf( n The return value is %g”,root); 

29 qDebug(str); 

30 } 
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31 } 

32 

33 client->detach(); 

34 return (0); 

35} 

이 실례는 이 전 실례와 갈은 일을 수행하지 만 결과를 기 다렸다가 현시한다 . 

18 행의 call() 호출은 통보문을 보내고 결과를 기다린다 . 호출은 이전 실례와 같지만 20 행 
에 2 개 의 돌림 값이 있다 . replyType 인수는 돌림 값의 자료형 을 가지 고 돌아오며 reply 인수는 
실제돌림값을 포함한다 . 

callO 호출이 성 공하면 23 행 에 서 되 돌아온 QByteArray 로부터 값들을 읽어 들이 기 위 하여 
QDateStream 을 창조한다 . 돌림값의 자료형은 24 행에서 검사되고 26 행에서 국부변수에 보관 
되여 str 라는 문자렬을 만드는데 사용되며 그다음 현시된다 . 

출력은 다음과 갈다 . 

The return value is 9.61179 

그림 15-1 에서는 한 통보문을 tellwilbur 로부터 받고 다른 통보문은 askwilbur 로부터 받은 
후에 wilbur 에 의해 현시된 창문을 보여준다 . 



wilbur registered as "wilbur" 
Cube root of 999 is 9.99667 
Cube root of 999 is 9.99667 
Cube root of 888 Is 9.61179 


그림 15-1. 세 통보문을 받은 후의 Wilbur 

제2절. 지령행인수 

KCmdLineArgs 클라스는 지령행 인수를 확인하고 해석하는 대부분의 일을 조종할뿐아니 
라 모든 KDE 응용프로그람들의 지령행 인수들이 일관하도록 한다 . 아래의 프로그람은 
KCmdLineArgs 를 사용하는 기초를 보여 준다 . 

CommandLine 

1 /* commandline.cpp */ 

2 #include <kcmdlineargs .h> 

3 #include <iostream.h> 

4 
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5 static KCmdLineOptions options [] = { 

6 { ，， x，，，，，A binary option",0}, 

7 {，，o <name>",，，An option with data M ,7dev/null M }, 

8 {"longbin", "A binary option",0}, 

9 {"longdata <name>’’,"An option with data’’,"/dev/nuir ’}， 

10 

11 {’’twoforms", ’’Two forms of a binary option",0}, 

12 {0,0,0} 



14 

15 int main(int argc,char **argv) 

16 { 

17 QCString option; 

18 KCmdLineArgs: :init(argc,argv, 

19 "commandline’’, 

20 "Example of command line parsing", 

21 "Version 0.0 n )； 

22 KCmdLineArgs::addCmdLineOptions(options); 

23 KCmdLineArgs *pargs = KCmdLineArgs: : parsedArgs(); 

24 

25 if(pargs- 〉 isSet("x")) 

26 cout« " -x is set" « endl; 

27 else 

28 cout« " -x is not set” « endl; 

29 option = pargs- 〉 getOption(“o’’); 

30 cout« ’’ -o is set to ’’ « option « endl; 

31 if(pargs->isSet( M longbin M )) 

32 cout« " —longbin is set" « endl; 

33 else 

34 cout« " —longbin is not set" « endl; 

35 option = pargs- 〉 getOption("longdata M ); 

36 cout« ’’ —longdata is set to ’’ « option « endl; 

37 

38 pargs->clear(); 

39 return (0); 
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40} 

사용할수 있는 지령행인수들은 5 행의 KCmdLineOptions 객체들의 배렬로서 정의된다 . 배 
렬에서 선택한 지령은 3 개 문자렬로 이루어져있다 . 첫째 문자렬은 지령행에 나타나는 문자 
( 렬)이고 둘째는 선택한 지령의 간단한 설명 그리고 셋째는 선택한 지령의 초기값문자렬이 
다 . 선택들의 배렬은 12 행에서 3 개의 null 문자렬을 포함하고있는 값들로 끝난다 . 

18 행의 정적메쏘드 init () 호출은 KCmdLineArgs 클라스의 정적자료를 초기화한다 . 처음 2 
개 인수는 C ++ 지령으로부터 들어오는 표준 argc 와 argv 변수이다 . 이것들은 프로그람의 이름 , 
프로그람의 간단한 설명 그리 고 프로그람의 현재 판번호이다 . 

22 행의 addCmdLineOptions () 호출은 KCmdLineArgs 클라스안에 KCmdLineOptions 표를 보관 
한다 . KCmdLineArgs 클라스내부에 미리 정의된것들과 함께 이 선택목록은 가능한 모든 선택 
의 설정값을 결정하는데 필요한 정보이다 . 

23 행의 정 적메쏘드 parseArgs () 호출은 정 의된 선택들에 대하여 지 령행을 해석한다 . 오유 
가 없으면 이 메쏘드는 자기 프로그람이 받아들일 준비 가 되 여있는 인수값들을 가진 
KCmdLineArgs 객체의 지적자를 돌려준다 . 지 령행에서 모순되는 인수가 발견되면 프로그람은 
오유통보문을 현시 하고 프로그람을 정 지한다 . 

6 행에서 지정된 -x 선택은 2 진기발이다 . 즉 그것이 지령행에 나타났는가 아닌가하는 정 
보를 가진다 . 25 행의 isSet() 호출은 값이 지령행에 나타났으면 TRUE 를，그렇지 않으면 FALSE 
를 돌려준다 . 

7 행에서 지정된 -o 선택은 지 령행에서 값이 그뒤 에 올것을 요구하는 선택이다 . 지 령행에 
값이 없을 때 사용하는 기정값문자렬을 제공한다 .29 행의 getOptionO 호출은 인수값을 엄는다 . 

선택이름이 1 문자이상이면 지 령행에서 2 개의 풀이표를 요구한다 . 8 행에서 정의한 
-longbin 선택은 31 행에서 isSet () 호출에 의 해 검사되는 2 진기 발이다 . 一 longdata 선택은 자료가 
그뒤에 올것을 요구하며 그 값은 35 행의 getOption () 호출에 의해 얻는다 . 

10 행과 11 행은 갈은것을 의미하는 2 개의 기발을 지정하는 한가지 실례이다 . 둘째와 셋 
째 인수들을 모두 null 지적자로 함으로써 -t 선택이 -형식선택의 동의어로 된다 . 지령행에서 
그리고 프로그람내에서 그것을 사용할수 있다 . 

38 행의 clearQ 호출은 프로그람이 완료하려고 하기때문에 이 실례에서는 필요하지 않지만 인 
수자료가 매우 큰 경우에 할당된 기억기를 해방하는데 이 메쏘드를 사용할수 있다 . 

이 실례 에서 다음 지 령행은 두가지 기 발을 지 정한다 . 
commandline -x —longdata /mnt/fred 

프로그람에 의해 현시된 본문은 다음과 갈다 . 

- x is set 

-o is set to /dev/null 
-longbin is not set 
—longdata is set to /mnt/fred 
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오유가 있으면 23 행의 parseArgsO 호출은 프로그람을 중지하고 통보문을 현시한다 . 실례 
로 다음 지 령행은 알려지 지 않은 기 발을 지 정 한다 . 
commandline -x -j 

출력 은 프로그람이 름을 포함하며 다음과 갈은 알려 지 지 않은 선택을 지 정한다 . 


commandline: Unknown option ’-j’. 

commandline: Use -help to get a list of available command line options, 
-help 선택을 리용하면 가능한 선택들의 전체목록을 얻을수 있다 . 
Usage : commandline [ Qt-options ] [ KDE-options ] [ options ] 

Example of command line parsing 


Generic options : 
—help 
—help-qt 
—help-kde 
-help-all 
—author 


Show help about options 
Show Qt specific options 
Show KDE specific options 
Show all options 
Show author information 


-V, —version 

Options: 

-x 

-o <name> 

—longbin 

—longdata <name> 



Show version information 
End of options 

A binary option 

An option with data [/dev/null] 

A binary option 

An option with data [/dev/null] 

Two forms of a binary option 


제 3 절. 유일한 응용프로그람 

어떤 응용프로그람들은 어떤 순간에 실행중에 있는 자기 사본이 2 개이상 되지 않도록 
보호하여야 한다 . 이것은 응용프로그람을 DCOP 봉사기로 등록함으로써 달성되며 그자체가 
이미 등록되였으면 다른 사본이 벌써 실행되고있다고 가정한다 . 다음 실례는 프로그람의 실 
례 가 2 개 이 상 있을수 없다는것 을 담보하기 위 하여 KApplication 대 신 에 KUniqueApplication 을 
사용한다 . 

Unique 

1 /* unique.cpp */ 

2 

3 #include <kuniqueapp.h> 

4 #include <kaboutdata.h> 
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5 #include <kcmdlineargs .h> 

6 #include <qlabel.h> 

7 #include <iostream.h> 

8 

9 static KCmdLineOptions options[] = { 

10 {"x"，，，A Binary option",0 }， 

11 { 0 , 0 , 0 } 

12}； 

13 

14 int main(int argc,char **argv) 

15 { 

16 KAboutData about("unique", 

17 "Example of unique application", 

is ， ’ o.r); 

19 KCmdLine Args :: init(argc,argv,&about); 

20 KCmdLineArgs::addCmdLineOptions(options); 

21 KUnique Application: : addCmdLineOptions(); 

22 

23 if(!KUniqueApplication: : start()) { 

24 cout« "Unique is already running" « endl; 

25 exit(0); 

26 } 

27 

28 KUniqueApplication kuapp; 

29 QLabel *label = new QLabel("Unique",0); 

30 label->setAlignment(Qt: : AlignVCenter 

31 | Qt: : AlignHCenter); 

32 label->show(); 

3 3 kuapp. setMainW idget(label); 

34 return (kuapp.exec()); 

35} 

19 행에서 KCmdLineArgs 의 init() 메쏘드호출은 지령행인수들을 해석하고 보관한다 . 
KAboutData 객체는 기본적 인 응용프로그람정의문자렬들 즉 프로그람이름 , 간단한 설명 이름 
그리고 판번호들을 포함한다 . 20 행의 addCmdLineOptionsO 호출은 9 행의 표에서 소개한 선택들 
을 정의하는데 사용되며 21 행의 addCmdLineOptionsO 호출은 KUniqueApplication 클라스에 지정 
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된 선택들을 포함한다 . 

23 행의 startO 호출은 프로그람의 이 실례를 실행하려고 하는가 , 또는 그것이 유일하지 
않기때문에 완료하려고 하는가 알아야 할 때 필요하다 . startO 호출이 이루어지지 않으면 프로 
그람의 한개 사본이 이미 실행되고있으며 이 프로그람은 28 행에서 KUniqueApplication 객체를 
창조하려고 시도할 때 조용히 정지된다 . 

KUniqueApplication 클라스는 KApplication 을 기초클라스로 사용하므로 28 행에서 창조된 
kuapp 객체는 그것이 KApplication 객체인것처럼 취급될수 있다 . QLabel 창문부품이 만들어지고 
29 〜 33 행에서 기본창문창문부품으로 설치되며 응용프로그람의 실행순환고리는 34 행에서 호 
출된 다 . 


제4절. 실례매플레트 

애플레트는 하나의 작은 창문을 현시하는 프로그람이고 창문은 보통 현시기의 아래에 
나타나는 KDE 구획에 있다 . 이 창문한계외에 애플레트는 다른 프로그람처럼 크고 복잡할수 
있 다 . 

다음 실례애플레트는 본문을 포함하는 구획창문을 현시 하며 kmail 응용프로그람을 기 동 
함으로써 마우스단추에 응답한다 . 이것은 아주 간단한 애플레트이다 . 사용할 때 응용프로그 
탐이 우연히 여러번 기동되지 않도록 보호하는것이 필요하며 몇가지 반결합을 사용자에게 
제공하여 애플레트가 마우스에 응답하고 있다는것을 사용자가 알게 한다 . 

구획이 수직 또는 수평으로 현시하도록 배렬할수 있고 창문크기조절규칙이 두 방향에 
서 약간 다르기때문에 애플레트는 매개 방향의 크기를 구획 에 알려주어 야 한다 . 

MailApplet 머 리 부파 일 

1 /* mailapplet.h */ 

2 #ifndefMAILAPPLET_H 

3 #defme MAILAPPLET_H 

4 

5 #include <qfontmetrics.h> 

6 #include <kpanelapplet.h> 

7 

8 class MailApplet: public KPanelApplet 

9{ 

10 Q_OBJECT 

11 public: 

12 MailApplet(QWidget *parent=0,const char *name=0); 

13 int widthF orHeight(int height); 

14 int heightF orWidth(int width); 
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15 void about(); 

16 void help(); 

17 void preferences(); 

18 protected: 

19 void paintEvent(QPaintEvent *e); 

20 void mousePressEvent(QMouseEvent *e); 

21 }； 

22 

23 #endif 

애플레트의 기초클라스는 KPanelApplet 이다 . KPanelApplet 는 QWidget 를 기초클라스중의 
하나로 사용하므로 코드는 창문에 대한 직접호출을 가진다 . 10 행의 마크로 Q_OBJECT 는 다 
른 KDE 창문응용프로그람처럼 MOC 를파일러에 의해 사용되므로 처리부와 신호의 표준형식 
을 사용할수 있다 . 메쏘드 widthForHeight() 와 heightForWidth() 는 기초클라스에서 가상메쏘드 
로 선언되므로 그것들은 애플레트에서 실현되여야 한다 . 

MailApplet 

1 /* mailapplet.cpp */ 

2 #include <kapplication.h> 

3 #include <kcmdlineargs .h> 

4 #include <kmessagebox.h> 

5 #include <kaboutdialog.h> 

6 #include <qpainter.h> 

7 #include <stdlib.h> 

8 #include "mailapplet.h" 

9 

10 #defme vText "VERT ，， 

11 #define hText "HORIZ" 

12 

13 int main(int argc’char **argv) 

14 { 

15 KCmdLineArgs: :init(argc,argv, 

16 "mailapplet", 

17 "Mail Applet Example”, 

18 "Version 0.0 ")； 

19 KApplication app; 

20 MailApplet *applet = new MailApplet(0, "mailapplet"); 





21 app. setMainW idget(applet); 

22 applet- 〉 init(argc,argv); 

23 return (app.exec()); 

24} 

25 MailApplet: : MailApplet(QWidget ^parent,const char *name) 

26 : KPanelApplet(parent,name) 

27 { 

28 setActions(About | Help | Preferences); 

29 setFont(QFont( ，， Courier", 16,QFont: : Bold)); 

30} 

31 void MailApplet: : about() 

32 { 

33 KAboutDialog * about = new KAboutDialog(0, "mailapplet"); 

34 about->exec(); 

35} 

36 void MailApplet: :help() 

37 { 

38 KMessageBox: : information(0, 

39 "The MailApplet Help Dialog ")； 

40} 

41 void MailApplet: :preferences() 

42 { 

43 KMessageBox: : information^, 

44 "The MailApplet Preferences Dialog"); 

45} 

46 int MailApplet: : heightForWidth(int width) 

47 { 

48 QFontMetrics fm = fontMetrics(); 

49 return (fm.height()); 

50} 

51 int MailApplet: : widthForHeight(int height) 

52 { 

53 QFontMetrics fm = fontMetrics(); 

54 return (fm.width(hText)); 

55} 
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56 void MailApplet: : paintEvent(QPaintEvent *e) 

57 { 

58 QPainter p(this); 

59 QFontMetrics fm = fontMetrics(); 

60 if(orientation() == Vertical) { 

61 int y = height() / 2; 

62 y += (fm.ascent() - fm.descent()) / 2; 

63 int x = (width() - fm.width(vText)) / 2; 

64 p.drawText(x,y,vText); 

65 } else { 

66 int y = height() / 2; 

67 y += (fm.ascent() - fm.descent()) / 2; 

68 int x = (width() - fm.width(hText)) / 2; 

69 p. drawT ext(x,y,hT ext); 

70 } 

71} 

72 void MailApplet::mousePressEvent(QMouseEvent *e) 

73 { 

74 system("kmail &")； 

75} 

애플레트는 다른 응용프로그람과 아주 비숫하다 . 중요한 차이는 기본창문부품이 
KPanelApplet 클라스를 기 초클라스로 사용하는것 이 다.(또한 QWidget 를 기 초클라스로 사용한 
다 .) 

13 행 에 서 시 작하는 애 플레 트의 기 본함수는 KCmdLineArgs 를 사용하여 지 령 행 정 보를 읽 
어들이 고 서술본문정보를 초기화한다 . 19 행에서 KApplication 객체는 KCmdLineArgs 의 init() 메 
쏘드에 의해 보관된 대 역정보를 사용하므로 인수없이 만들어 진다 . 이 응용프로그람의 기본 
창문부품은 20 행과 21 행에서 만들어진다 . 22 행에서 MailApplet 의 기초클라스 KPanelApplet 의 
init() 메쏘드호출은 애플레트에 지 령행 인수들을 넘긴다 . 

25 행의 MailApplet 구성자는 KPanelApplet 구성자에 부모창문부품과 애플레트이름을 넘긴 
다 . 28 행의 setActionsO 호출은 3 개 선택 차림표항목중 어느것을 애플레트차림표로 포함해야 하 
는가 지 정한다 . (차림 표를 표시 하기 위 하여 애 플레 트를 이 동시 키 는 띠 우에 서 마우스오른쪽단 
추를 사용한다 .) 이 실례에서 3 개의 선택차림표항목들이 모두 나타난다 . 29 행의 setFontO 호출 
은 창문부품의 기 정서 체를 설정한다 . 

About 항목이 28 행의 setActions() 에 의해 지정되 였으므로 31 행의 aboutQ 메쏘드는 사용자 
가 차림표로부터 "About” 를 선택할 때마다 호출된다 . 이 실례는 간단히 빈 About 칸을 현시한 
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다 . 마찬가지로 Help 와 Preference 가 setActions () 호출에서 지정되였으므로 Help 와 Preferences 차 
림표항목들은 36 행과 41 행에서 help () 와 preference !} 메쏘드들을 호출하게 한다 . 

구획이 수평방향으로 현시될 때 모든 애플레트는 고정높이를 가지지만 너비는 변할수 
있다 . 너비를 결정하기 위하여 51 행에서 메쏘드 wic 油 ForHeight () 를 호출한다 . 애플레트가 크 
기 를 결심하여 야 하는 경우에 높이값이 주어지면 이 메쏘드는 너 비를 계산하여 돌려준다 . 
이 실례에서 그림 15-2 와 같이 너비는 본문의 수평범위이다 . 

^ horiz^ [천 

그림 15-2. 수평방향의 구획을 가지는 애플레트 
구획 이 수직방향으로 현시 될 때 모든 애 플레트는 고정너 비를 가지 지만 매개는 자체의 
높이를 지정해야 한다 . 그래서 46 행의 메쏘드 heightforWidthO 를 호출한다 . 그림 15-3 과 같이 
이 실례에서 높이는 현시된 본문의 높이이다 . 


1 

VBRT 

m 

그림 15-3. 수직방향의 구획을 가지는 애플레트 
56 행의 paintEvent () 메 쏘드는 창문부품을 그릴 때마다 호출된 다 . 60 행의 orientationO 메쏘 
드는 구획의 방향에 따라 Vertical 혹은 Horizontal 을 돌려준다 . 이 실례에서 방향을 설명하는 
본문이 선택되고 본문의 위치는 애플레트창문의 중심에 본문이 나타나도록 계산된다 . 

이 실례는 72 행의 mousePressEvent () 메쏘드를 실현하고 kmail 응용프로그람을 기동하여 
마우스찰칵에 응답한다 . 


요 약 

응용프로그람들사이 통신은 2 개 이상의 실행 프로그람들을 요구하는 매우 복잡한 체계 에 
서 아주 중요하다 . 또한 표준메쏘드사용은 다른 프로젝트들의 부분으로서 씌여진 응용프로 
그람과의 통신을 가능하게 한다 . 

이 장은 다음과 갈은것을 설명하였다 . 

• KDE 는 dcopserver 라는 중간배경프로쎄스를 통하여 프로쎄스사이 통보문들을 송수신 

한다 . 

• 지 령 행 인수들을 읽고 처 리하는데서 KCmdLineArgs 클라스를 사용하면 지 령행 해석 프로 
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그람작성 이 간단해지고 모든 KDE 응용프로그람에서 인수형식을 표준화한다 . 

• KApplication 대신에 KUniqueApplication 을 사용하면 오직 한개 사본의 프로그람을 한번 
에 실행한다 . 

다음 장은 파일들의 읽기와 써넣기，날자와 시간조작과 같은 일을 처리하는데 리용할수 
있는 몇가지 일반편의클라스들을 서술한다 . 
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제 16 장. 일반편의클라스 

학습내용 

문자렬클라스에 의한 문자렬조작 

프로그람이 끝나는 시간을 통지하는 시계의 실행 

현재시간의 표식자와 경과시간의 검사 

날자와 달력계산 

파일로부터 본문의 읽어들이기 

파일에 본문의 써넣기 

GUI 대면부를 만드는데 사용하는 클라스들과 함께 다른 일 에 편리한 몇 가지 편의 클라스 
들이 있다 . 특히 문자별들과 고속으로，능률적으로 작업하는 능력은 매우 중요하다 . 자료의 
현시와 얻기와 관련한 많은 문자렬조작에서 문자렬취급은 편의클라스들이 없으면 매우 많은 
시 간을 소비할수 있 다 . 

응용프로그람작성에서 제기되는 다른 문제는 날자와 시간계산을 할수 있는 능력이다 . 
항상 여러가지 형식으로 시간을 돌려주는 조작체계호출이 있으며 시간값에 대한 복잡한 조 
작을 수행하려 면 많은 프로그람을 작성해 야 한다 . 실례로 2 개의 날자가 있다면 날자차이 가 
몇일인가를 어떻게 결정하겠는가 ? 

대부분의 큰 자료파일들은 저 장 및 복귀 를 위해 자료기 지 패키 지 에 주어지 지 만 임의 의 
크기의 대다수 프로그람들은 구체적인 자료를 보관하는데 작은 본문파일들을 사용한다 . C 와 
C ++ 표준언어들이 파일들을 읽고 쓰는 아주 간단한 방법을 제공하지만 자료들을 포함하는 
형식화와 비형식화문제가 여전히 존재한다 . 

이 장은 이 문제들을 해결하는 아주 편리한 클라스들을 설명한다 . 그것은 Qt 에서 사용 
할수 있는 모든 클라스의 완전목록을 의미하지 않으며 핵심클라스들중 일부를 포함한다 . 

제1절. 문자렬클라스 

많은 프로그람작성은 문자렬조작을 포함한다 . 특히 사용자대면부용프로그람을 만드는 
경우에는 더 많이 리용된다 . 자료는 현시하려는 문자렬들로 변환되고 사용자가 입력한 자료 
는 문자렬로부터 내부자료형식으로 바뀐다 . 이 모두를 쉽게 조종하는 특수한 문자렬취급클 
라스가 있다 . 

1. QString 

QString 클라스는 가장 기 초적 인 문자렬클라스이 다 . QString 클라스는 문자렬조작에 쓰이 는 
많은 메 쏘드들을 가지 고 있고 내 부적 으로 자료를 유니 코드로 기 억한다 . 

유니코드가 대단히 많은 문자들을 포함하는것을 제외하고 유니코드와 ASCII 문자모임사 
이에 차이가 없다 . 표준 7bit ASCII 문자모임은 127 개 문자로 제한되며 라린자모，아라비아수 
자，구두점 그리고 일련의 조종문자 (Carriage Return 과 Escape 등 ) 등이 있다 . 유니코드표준은 
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16bit 문자를 사용하므로 65 536 개 문자까지 포함할수 있다 . 그러나 유니코드문자모임의 첫 
127 개문자 (0 〜 127 의 수값)는 ASCII 문자모임과 갈으므로 ASCII 를 유니코드로 바꿀 필요가 없 
다 . 또한 라린문자유니코드를 ASCII 로 바꿀 필요도 없다 . 

| 참고 : 유니코드사용법 에 대한 더 많은 정보를 알려 면 17 장을 보시오 . j 

다음 실례는 문자렬의 부분을 탐색하고 추출하는데 사용할수 있는 메쏘드들중 일부를 
보여 준다 . 

1 /* stringexamine.cpp */ 

2 #include <qstring.h> 

3 #include <iostream.h> 

4 

5 int main(int argc’char **argv) 

6 { 

7 QString qstring; 

8 QChar qchar; 

9 

10 qstring = 

11 "There is much more to KDE than just a pretty face."; 

12 

13 cout« qstring « endl; 

14 cout« "The string contains ’’ 

15 « qstring.length()« ’’ characters." « endl; 

16 qchar = qstring[4]; 

17 cout« "The 5th charater is ，，， 

18 « (char)qchar.unicode()« « endl; 

19 cout« "The first ， u，is at" 

20 « qstring.find( ， u，) « ".，，« endl; 

21 cout« ’’The last ’u’ is at “ 

22 « qstring.findRev( ， u，) « « endl; 

23 cout« "The first ， re，is at" 

24 « qstring.fmd( M re M ) « « endl; 

25 cout« ’’The last ’re’ is at “ 

26 « qstring.findRev( ，， re，，)« « endl; 

27 cout« "There are ，， 

28 « qstring.contains(‘e，)« " ， e ， s." « endl; 

29 cout« "There are ，， 
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30 « qstring.contains( M re")« ，’ 're's." « endl; 

31 cout« ’’The leading 7 characters are … 

32 « qstring.left(7) « « endl; 

33 cout« ’’The trailing 7 characters are 

34 « qstring.right(7) « « endl; 

35 cout« ’’The 8 characters at index 22 are ’’’ 

36 « qstring.mid(22,8) « « endl; 

37 

38 return 0; 

39} 

이 프로그람의 출력은 다음과 같다 . 

There is much more to KDE than just a pretty face. 

The string contains 50 characters. 

The 5th charater is ’e’. 

The first ’u’ is at 10. 

The last ’u’ is at 32. 

The first ’re，is at 3. 

The last ’re’ is at 39. 

There are 5 ’e ， s. 

There are 3 're's. 

The leading 7 characters are ’There i’. 

The trailing 7 characters are ’y face. 

The 8 characters at index 22 are ’KDE than'. 

QString 을 만드는데 쓰이는 여러가지 구성자들이 있다 . QString 은 간단한 문자배렬， 
QByteArray, QChar, QChar 객체배렬，다른 QString 으로부터 만들수 있으며 또는 아무것도 지정 
하지 않고 (0 길이문자렬 ) 만들수 있다 . QChar 객체는 하나의 유니코드문자를 보관하는 용기인 
데 다음 장에 서 설 명한다 . 

문자렬조작을 제공하는 다중정의된 연산자들이 여러개 있다 . 이 실례의 10 행과 11 행에 
서 대입연산자는 문자렬을 유니코드로 바꾸어 QString 객체에 보관하는데 쓰인다 . 또한 
QString, QCString, QChar 그리 고 char 용의 대 입연산자다중정 의 가 있다 . 마찬가지 로 +=연산자 
는 QString, QChar, 또는 char 를 현존 QString 의 끝에 추가하는데 쓰인다 . 

20 행과 24 행에서 frndO 메쏘드들은 문자렬의 선두로부터 조사하여 문자 혹은 문자렬의 
첫 출현을 발견하고 람색한 부분문자렬의 선두문자의 첨수를 돌려준다 . 22 행과 26 행의 
findRevO 메쏘드는 문자렬의 끝으로부터 조사하여 마지막 출현을 발견하고 부분문자렬의 선 
두의 첨수를 돌려준다 . 28 행과 30 행의 contains () 메쏘드들은 전체 문자렬을 조사하고 문자 또 
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는 부분문자렬의 출현회수를 돌려준다. 

32 행과 34 행의 메쏘드 left() 와 right() 는 문자렬의 선두 혹은 끝에서 지정된 개수의 문자 
들을 포함하는 QStting 을 돌려준다. 36 행의 mid() 메쏘드는 문자렬의 첨수위치로부터 지정된 
개수의 문자들을 포함하는 QStting 을 돌려준다.(이 실례에서 첨수는 22 이고 문자수는 8 이다.：) 
2. QString 

QString 의 내용을 변경하는데 많은 메쏘드를 사용할수 있다. 다음 실례는 일부 필요한 
메쏘드들을 보여준다. 

1 /* stringmodify.cpp */ 

2 #include <qstring.h> 

3 #include <iostream.h> 

4 

5 QString init(QString str) 

6 { 

7 str = "There is more to KDE than a pretty face.’’; 

8 return str; 

9} 

10 

11 int main(int argc,char **argv) 

12 { 

13 QString qstring; 

14 

15 cout« "Unchanged: ’’ 

16 «init(qstring) « endl; 

17 cout« "Uppper case: ’’ 

18 «init(qstring).upper() « endl; 

19 cout« "Lower case: ’’ 

20 «init(qstring).lower()« endl; 

21 cout« "Insert，X，: M 

22 «init(qstring).insert(10,’X’) « endl; 

23 cout《’’Insert’ABC，: ，’ 

24 «init(qstring).insert(10, "ABC") « endl; 

25 cout« "Prepend'X 1 : ，’ 

26 «init(qstring).prepend( 4 X 9 ) « endl; 

27 cout« "Prepend，ABC，:" 

28 « init(qstring).prepend( ,, ABC n ) « endl; 






29 cout« "Append ， X ， : ，， 

30 «init(qstring).append( , X , ) « endl; 

31 cout《"Append‘ABC，: “ 

32 «init(qstring).append(’’ABC") « endl; 

33 cout« "Remove 10:" 

34 «init(qstring).remove( 15,10) « endl; 

35 cout« "Replace 10: M 

36 «init(qstring).replace(15,10, "ABC")«endl; 

37 

38 return 0; 

39} 

출력은 다음과 갈다 . 

Unchanged: There is more to KDE than a pretty face. 

Uppper case: THERE IS MORE TO KDE THAN A PRETTY FACE. 

Lower case: there is more to kde than a pretty face. 

Insert 'X': There is mXore to KDE than a pretty face. 

Insert ’ABC’: There is mABCore to KDE than a pretty face. 

Prepend 'X': XThere is more to KDE than a pretty face. 

Prepend 'ABC': ABCThere is more to KDE than a pretty face. 

Append 'X': There is more to KDE than a pretty face.X 
Append 'ABC': There is more to KDE than a pretty face.ABC 
Remove 10: There is more t a pretty face. 

Replace 10: There is more tABC a pretty face. 

이 실례는 QString 의 매개 메쏘드가 QString 객체의 내용을 변경하기때문에 5 행에서 init(} 
함수에 의하여 문자렬을 초기화한다 . 

18 행 과 20 행 의 upper () 와 lower () 메 쏘드들은 문자렬 안의 모든 영 문자를 대 문자 혹은 소 
문자로 변환한다 . 

22 행과 24 행의 insertO 는 삽입하려는 문자들의 수만큼 문자렬의 일부를 오른쪽으로 이 
동하여 문자렬을 확장한다 . 그다음 문자렬에 생겨난 짱에 인수로 넘긴 문자 ( 들)이 삽입된다 . 

26 행과 28 행에서 prependO 메쏘드는 삽입하려는 문자수만큼 모든 문자렬을 오른쪽으로 
이동하여 문자렬을 확장한다 . 그 다음에 문자렬의 앞에 생긴 짱에 인수로 넘긴 문자 ( 들)이 
삽입된다 . 

30 행과 32 행에서 append 。 메 쏘드는 삽입하려는 문자수만큼 문자렬을 확장하고 문자렬의 
오른쪽끝에 생긴 짬에 문자들을 보관한다 . 

34 행의 removeO 메쏘드는 지정된 문자수만큼 나머지 문자렬을 오른쪽으로 옮기여 문자 




렬을 축소한다. 이리하여 중심의 문자모임을 문자렬로부터 효과적으로 삭제하면서 그 우에 
다시 써넣는다. 이 실례에서 첨수는 15 이고 제거된 문자수는 10 이다. 

36 행의 replaceO 메쏘드는 문자렬을 확장 및 축소하거나 같은 길이로 만드는데 쓰인다. 
문자렬안의 일부 문자들은 교체된다. 그 과정은 remove() 다음에 insert() 한것과 기능적으로 같 
다. 첨수위치(이 실례에서 15) 의 오른쪽 문자들은 삽입 혹은 삭제하려는 문자수에 따라 오른 
쪽으로 또는 왼쪽으로 옮겨진다(이 실례에서 10 문자를 삭제하고 3 개를 삽입해야 하므로 7 개 
문자만큼 왼쪽으로 옳긴다). 지정된 문자렬은 그다음 첨수위치에서 다시 써넣는다. 

3. QString- 

수값과 수값의 문자표시 사이 의 직 접변환메 쏘드들이 QString 클라스의 부분으로서 포함되 
여있다. 다음 실례는 그 동작을 보여준다. 

1 /* stringnumber.cpp */ 

2 #include <qstring.h> 

3 #include <iostream.h> 

4 

5 int main(int argc’char **argv) 

6 { 

7 QString qstring; 

8 bool Ok; 

9 

10 int inum = 9421; 

11 qstring. setNum(inum); 

12 cout« "Short string: " « qstring « endl; 

13 inum = qstring.toInt(&Ok); 

14 cout« "Short value:" «inum « endl; 

15 

16 double dnum = 2813.8282190; 

17 qstring. setNum(dnum); 

18 cout« ’’Double string at 6: " « qstring « endl; 

19 dnum = qstring. toDouble(&Ok); 

20 cout« ’’Double value at 6: " « dnum « endl; 

21 

22 dnum = 2813.8282190; 

23 qstring.setNum(dnum, ’g’,9); 

24 cout« "Double string at 9: " « qstring « endl; 

25 dnum = qstring.toDouble(&Ok); 




26 cout« ’’Double value at 9: " « dnum « endl; 

27 

28 ulong ulnum = 0xCFA90B2; 

29 qstring.setNum(ulnum, 16); 

30 cout« "Ulong string: " « qstring « endl; 

31 ulnum = qstring.toULong(&Ok, 16); 

32 cout« "Ulong value: ’’ « ulnum « endl; 

33 

34 qstring.sprintf("The int is %d and the long is %lu", 

35 inum,ulnum); 

36 cout« qstring « endl; 

37 

38 return 0; 

39} 

프로그람의 출력은 다음과 갈다 . 

Short string: 9421 

Short value: 9421 

Double string at 6: 2813.83 

Double value at 6: 2813.83 

Double string at 9: 2813.82822 

Double value at 9: 2813.83 

Ulong string: cfa90b2 

Ulong value: 217747634 

The int is 9421 and the long is 217747634 

이 실례는 몇 가지 자료형들을 보여준다 . 여 기서 보여준 int, double, ulong 자료형들과 함께 
long , uint , short , ushort, char 및 QChar 에 서 도 같은 수법 을 사용할수 있 다 . 

11 행의 setNumO 호출은 12 행에서 cout 에 의해 보여준것처럼 int 값을 문자렬로 변환한다 . 
13 행 의 toInt() 호출은 QString 의 문자들을 읽어 들이 고 14 행 에서 보여 준것 처 럼 int 값으로 변환 
한다 . 변환이 성공하면 tolntf} 에 넘긴 론리인수는 TRUE 로 되고 그렇지 않으면(실례로 문자 
렬에 수자가 없으면 ) FALSE 로 된다 . 

17 행의 setNum() 호출은 double 값을 문자렬로 변환한다 . 기정은 18 행에서 cout 문에 의해 
보여준것처럼 6 자리를 포함하는 수자이다 . 수자수를 줄일 때 값을 간단히 잘라버러지 않고 
반올림한다 . 19 행에서 toDouble() 호출에 의해 문자렬을 수값형식으로 역변환하였을 때 그것은 
오직 문자렬에 보관되였던 6 개 수자를 포함한다 . 

22 〜 26 행은 이전처럼 같은 double 값을 사용하지만 이번에는 수자들의 개수는 9 로 설정 




되고 문자렬이 더 길어지고 좀 더 정확하다 . 문자 g 는 문자렬을 형식화하는데 사용된다 . 이 
것은 기정이지만 표준 sprintf () 실수선택 즉 f,F ， e ， E,g 및 G 를 사용할수 있다 . 

29 행의 setNumf } 호출에서 보여주는것처럼 10 이 아닌 기수로 값을 변환할수 있다 . 이 실 
례는 ulong 형의 32bit 16 진수를 문자렬로 변환한다 . 31 행의 toULong () 호출은 16 진문자들의 문 
자렬을 2 진수형식으로 변환한다 . setNum () 메쏘드는 수를 전부 소문자로 바꾸지만 toULong () 은 
소문자와 대문자를 모두 변환한다 . 

34 행에 보여준것처럼 sprintfO 를 사용할수 있다 . 인수형식은 표준 C 와 갈고 결과문자렬 
은 QString 객 체내 부에 보관된 다 . 

4. QString 

내부변환기는 대화칸의 본문이나 단추나 표식자의 본문으로 현시하려는 문자렬들을 구 
성하는데 아주 편리하다 . 그것은 sprintfO 함수와 류사하지만 자동적으로 다른 자료형들을 람 
색하므로 사용하기 더 쉽다 . 다음 실례는 그것 이 2 개의 값들과 작업 하는 방법 을 보여 준다 . 

1 /* stringargs.cpp */ 

2 #include <kapplication.h> 

3 #include <qlabel.h> 

4 

5 class StringArgs: public QWidget 

6 { 

7 public: 

8 StringArgs(QWidget *parent=0,const char *name=0); 

9 }； 

10 int main(int argc,char **argv) 

11 { 

12 KApplication app(argc,argv, "stringargs"); 

13 StringArgs stringargs; 

14 app.setMainWidget(&stringargs); 

15 stringargs. show(); 

16 return app.exec(); 

17} 

18 

19 StringArgs:: StringArgs(QWidget *parent,const char *name) 

20 : QWidget(parent,name) 

21 { 

22 int y = 60; 

23 int x = 210; 
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24 QString str; 

25 

26 resize(x,y); 

27 str = tr("Width is %1 and height is %2").arg(x).arg(y); 

28 QLabel *label = new QLabel(str,this); 

29 label->setGeometry(20,20,170,20); 

30} 

27 행의 tr () 메쏘드는 QString 객체를 만들고 2 개 arg () 메쏘드에 의하여 자료를 문자렬들로 
변환하고 %1 와 %2 로 표식된 위치에 그것들을 삽입한다 . 모든 자료를 변환하여야 할 때 많 
은 arg () 메쏘드들을 사용할수 있다 . arg () 메쏘드들은 위치관계를 가지며 첫째는 %1 에 대응하 
고 둘째는 %2 에 대응된다 . 이 프로그람에 의해 현시된 창문은 그림 16-1 에 보여준다 . 



그림 16-1. 자료변환과 형식화 

이 실례의 int 자료형 외 에 long , ulong , uint , short , ushort , char , QChar , QS 仕 ing 및 double 용 
arg () 메쏘드들이 다중정의된다 . 변환메쏘드가 QObject :: tr () 이므로 이러한 변환은 오직 QObject 
를 계승하는 객체들에서만 사용될수 있다 . 

5. QString 

문자렬에서 공백문자에는 타브어 ), 행바꾸기 (\n), 종이바꿈 (\f), 복귀야 ) 및 공백기호들이 속한 
다 . 문자별에서 공백을 제거하는데 편리한 메쏘드가 있다 . 다음것은 실례문자렬이다 . 

" This has\t tabs \nand\nnewlines in it \n " 

공백 은 아래 와 같은것 을 리 용하여 제 거할수 있다 . 
str.stripWhiteSpace(); 

결과는 다음과 같다 . 

"This has\t tabs \nand\nnewlines in it" 

행 의 앞과 뒤 또한 안으로부터 공백 을 다음과 갈은 방법 으로 삭제할수 있 다 . 
str.simplifyWhiteSpace(); 

앞과 뒤는 잘리우고 다수의 내부공백문자는 한개 공백으로 줄어든다 . 결과는 다음과 갈다 . 
"This has tabs and newlines in it" 

6. QStringList. 

QStringList 객체는 QString 객체의 가변길이배 렬이다 . 이것을 매우 효과적으로 사용하여 
특수한 조작을 수행할수 있다 . 다음 실례는 배렬에 문자별들을 삽입하는 방법과 문자렬들을 
조작하는 방법들을 보여준다 . 




1 /* stringlist.cpp */ 

2 iinclude <qstringlist.h> 

3 #include <iostream.h> 

4 

5 int main(int argc’char **argv) 

6 { 

7 QStringList list; 

8 

9 list.append( M First n )； 

10 list+= "Second"; 

11 list« "Third，，« ’’Fourth" « "Fifth"; 

12 for(int i=0; i<list.count(); i++) 

13 cout«list[i] « endl; 

14 

15 QString joined = list.join( MAM ); 

16 cout« endl« joined « endl; 

17 

18 list« "Apple" « "apple"; 

19 list.sort(); 

20 cout« endl; 

21 for(int i=0; i<list.count(); i++) 

22 cout«list[i] « endl; 

23 

24 list = list.grepC'e"); 

25 cout« endl; 

26 for(int i=0; i<list.count(); i++) 

27 cout«list[i] « endl; 

28 

29 list = QStrmgList::split("|’’, "Make|a|list|from|this"); 

30 cout« endl; 

31 for(int i=0; i<list.count(); i++) 

32 cout«list[i] « endl; 

33 

34 list[l] = "This replaces the V string"; 

35 cout« endl; 
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36 for(int i=0; i<list.count(); i++) 

37 cout«list[i] « endl; 

38 

39 return 0; 

40} 

이 프로그람의 출력은 다음과 갈다 . 
First 
Second 
Third 
Fourth 
Fifth 

First A Second A Third A Fourth A Fifth 

Apple 

Fifth 

First 

Fourth 

Second 

Third 

apple 

Apple 

Second 

apple 

Make 


list 

from 

this 

Make 

This replaces the ‘a’ string 

list 

from 

this 

9 〜 11 행은 문자렬을 배렬의 끝에 추가하는 각이한 방법들을 보여준다 . append() 메쏘드와 
. ᅮ_연산자는 둘다 배렬끝에 문자렬을 추가한다 . <<연산자도 같은 조작을 하며 하나의 조작으 
로 여러개 문자렬을 추가할수 있다 . 문자렬들이 코드에 추가되는 순서로 보관된다는것을 출 





력으로부터 알수 있다 . [] 연산자는 문자렬들을 첨수값에 따라서 엄을수 있도록 다중정의된다 . 

15 행의 joinO 메쏘드는 문자렬들사이에 특정한 분리기호문자렬을 삽입함으로써 배렬의 
모든 성원들로부터 하나의 긴 문자렬을 만든다 . 

18 행에서 2 개 성원을 배렬끝에 추가한다 . 19 행의 SO rt() 메쏘드는 문자들의 수값을 사용하 
여 문자별들의 배렬을 정렬한다 . 이것은 매우 빠른 정렬이고 많은 실례에서 사용할수 있지 
만 요구하지 않는 순서로 정렬하는 때가 있다 . 실례로 출력결과에서 보여준것처럼 대문자는 
항상 소문자앞에 온다 . 

24 행의 grep() 호출은 메쏘드호출에서 지정된 표현과 일치하는 문자들만 포함하는 새로 
운 QStringList 객체를 만든다 . 이 실례에서는 문자 e 를 포함하는 문자렬들만 새로운 
QS 仕 ingList 객체에 보관한다 . 

QStringList 객체는 특정한 구분기호문자렬을 사용하여 단일문자렬을 분리할수 있다 . 2 개 
의 련이은 구분기호들을 하나로 고찰해야 한다면 TRUE 로 설정하고 또는 길이가 0 인 문자렬 
이 허용되면 FALSE 로 설정하는 3 번째 인수가 있다(실례에서 사용하지 않았다 ). 기정은 
TRUE 이다 . 

34 행의 [] 연산자는 현재 문자렬을 그 첨 수를 사용하여 교체할수 있다 . 즉 첨 수값이 유 
효하면 배렬크기를 이려한 방법으로 조절할수 있다 . 

제2절. 시계의 실행 

13 장에서 bouncer 프로그람은 QTimer 객체를 사용하여 한번실행내부시계를 실현하는 실 
례를 포함하지만 신호대신에 사건을 사용하여 련속시계를 실행하는 더 간단한 방법도 있다 . 
다음 실례는 QObject 클라스의 메쏘드들을 사용함으로써 련속시계들을 실현하는 방법을 보여 
준다 . 

1 /* stringlist.cpp */ 

2 #include <qapplication.h> 

3 #include <iostream.h> 

4 

5 class TwoTimer: public QObject 

6 { 

7 public: 

8 TwoTimer(QObj ect *parent=0,const char *name=0); 

9 private: 

10 intIDl; 

11 int ID2; 

12 bool timer2; 

13 protected: 
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14 void timerEvent(QT imerEvent * event); 

15 }； 

16 

17 TwoTimer: : TwoTimer(QObject *parent,const char *name) 

18 : QObj ect(parent,name) 

19 { 

20 ID1 = startT imer(2000); 

21 } 

22 void TwoTimer :: timerEvent(QTimerEvent *event) 

23 { 

24 if(event->timerld() == ID1) { 

25 cout« "Timer 1" « endl; 

26 if(timer2) { 

27 killTimer(ID2); 

28 timer2 = FALSE; 

29 } else { 

30 ID2 = startTimer(200); 

31 timer2 = TRUE; 

32 } 

33 } else if(event->timerld() == ID2) { 

34 cout« "Timer 2" « endl; 

35 } 

36} 

37 

38 int main(int argc,char **argv) 

39 { 

40 QApplication app(argc,argv); 

41 TwoTimer *to = new TwoTimer(); 

42 return app.exec(); 

43} 

필요할 때 많은 시계들을 동시에 실행할수 있다 . 매 시계에는 실행시에 유일식별번호가 
할당된다 . 이 실례에서 TwoTimer 클라스는 2 개 시계를 실행하며 10 행과 11 행에서 11)1 과 ID2 
에 식별번호들을 보관한다 . 

17 행에서 시작하는 구성자는 20 행에서 startTimer() 를 호출하여 시계들중 하나를 실행시 
킨다 . 이 시계는 2000ms(2s) 마다 실행되며 11)1 로서 보관된 식별번호를 가지고있다 . 
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메쏘드 timerEventO 는 QObject 클라스에서 정의된 보호메쏘드이고 이 실례의 22 행에서 
재정의된다 . 모든 시계는 이와 같은 사건메쏘드를 호출한다 . QTimerEvent 객체는 시계의 식별 
번호를 포함하므로 어느 시계가 끝나고 메쏘드호출을 일으켰는지 결정하는것은 상대적으로 
간단하다 . 

이 실례 에서 첫째 시 계의 작용이 끝날 때마다 둘째 시 계가 기동하거 나 정 지한다 . 26 행 
에서 론리 형의 timer2 가 검사된다 . 그것 이 TRUE 이 면 둘째 시 계는 실행되 고있고 그것은 
killTimerO 를 호출함으로써 정지된다 . 그것이 FALSE 이면 둘째 시계는 200ms(2/10s) 의 시간간 
격 으로 startTimer() 을 호출하기 시 작한다 . 

38 행에서 시작하는 프로그람의 기본함수는 (^Application 객체를 만들고 시계들을 조종하 
는 Qt 체계를 초기화한다 . 시계를 만든 후에 QApplication 객체의 exec() 가 호출된다 . 시간조정 
은 모두 execO 내부에서 관리된다 . 

시계들을 취급하는 다른 메쏘드가 있으나 그것은 이 실례에서 사용되지 않는다 . 메쏘드 
killTimersO 호출은 모든 시 계 들을 정 지 한다 . 

제3절. QDate 클라스 

다음 실례는 1752 년부터 약 8000 년까지 모든 날자를 포함할수 있는 QDate 클라스들을 
설 명 한다 . 1752 가 아래 한계 인 리 유는 그것 이 윤년 을 가지 는 그레 고리달력 의 시 작을 표식 하는 
해 이 기때문이 다 . (그해 에 달력 이 어떻게 조절되는가 알기 위하여 지 령행으로부터 cal 1752 이 
라고 입 력 하여 9 월을 고찰한다 .；) 또한 1 년은 2 자리 값 (00 〜 99) 으로 QDate 객 체 에 입 력 할수 있 
고 세기 1900 이 가정된다 . 

1 /* showdate.cpp */ 

2 #include <qdatetime.h> 

3 #include <qstring.h> 

4 #include <iostream.h> 


6 int main(int argc’char **argv) 

7{ 

8 if(argc!=4){ 

9 cout« "Usage: showdate <yy> <mm> <dd>" « endl; 

10 return 1; 

11 } 

12 QStringyy = argv[l]; 

13 QString mm = argv[2]; 

14 QString dd = argv[3]; 

15 QDate date(yy.toInt(),imn.toInt(),dd.toInt()); 




16 if(!date.isValid()) { 

17 cout« "Invalid date" « endl; 

18 retum(2); 

19 } 

20 

21 cout« ’’Date: ’’ « date.toString()« endl; 

22 cout« "yyyy/mm/dd: ’’ « date.year()« 7’’ 

23 « date.month() « "/" « date.day()« endl; 

24 cout« "Day of week: ’’ « date.dayOfWeek()« " (" 

25 « date.dayName(date.dayOfWeek()) « ")" « endl; 

26 cout« "Month name:" 

27 « date.monthName(date.month())« endl; 

28 cout« "Day of year: ’’ « date.dayOfYear()« endl; 

29 cout« "Days in month:" 

30 « date.daysInMonth() « endl; 

31 cout« "Days in year:" « date.daysInYear() « endl; 

32 

33 return 0; 

34} 

이 프로그람을 실행하기 위하여 년，월 , 일을 지령행에 입력한다 . 

showdate 1964 3 12 

프로그람의 출력은 다음과 같다 . 

Date: Thu Mar 12 1964 
yyyy/mm/dd: 1964/3/12 
Day of week: 4 (Thu) 

Month name: Mar 
Day of year: 72 
Days in month: 31 
Days in year: 366 

QDate 에 날자를 보관하는 2 가지 방법이 있다 . 한가지 방법은 이 실례와 같이 구성자에 
서 년，월，일값들을 지정하는것이다 . 다른 방법은 setYMD() 호출에서 년 , 월 , 일을 지정하는 
것 이 다 . QDate 객체로부터 정 보를 사용하기 전에 날자가 유효한가 담보해 야 한다 . 이 실례의 
16 행에 보여준것처럼 isValid() 호출은 꼭 필요하다 . 또한 setYMD() 메쏘드는 날자가 유효한가 
가리 키 는 bool 값을 돌려 준다 . 

현재 날자를 포함한 QDate 객 체 를 정 적 메 쏘드에 의해 만들수 있다 . 
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QDate qdate = QDate: : currentDate(); 

또한 앞뒤로 옮길 날자수를 지정하여 날자를 조종할수 있다 . 실례로 15 일 앞으로 날자 
를 옮길 때 다음 행을 사용한다 . 

QDate date2 = date.addDays(15); 

날자수가 부수이면 새로운 QDate 객체는 15 일 이전의 날자를 가전다 . 어떠한 지정된 점 
까지 날자를 조종하는데 다른 유효값을 사용할수 있다 . 실례로 다음은 다음 달의 첫날까지 
날자를 이동한다 . 

QDate date2 = date.addDays(date.daysInMonth()-date.day()+ 1 ); 

한 날자로부터 다른 날자까지의 정이거나 부인 날자수는 다음과 같이 결정할수 있다 . 

int days = date.daysTo(date2); 

끝으로 다음과 같은 비교연산자들은 두 날자사이의 관계를 결정할수 있다 . 
if(datel = date2)... 
if(datel != date2)... 
if(datel < date2)... 
if(datel > date2)... 
if(datel <= date2)... 
if(datel >= date2)... 

제 4 절. QTime 클라스 

QTime 클라스는 계 산이 규칙 적이 라는데서 QDate 클라스보다 더 간단하다(월과 년과는 달 
리 시와 분은 같은 길이를 가지고있다 :). 그러나 그것을 경과시계로 사용할수 있다는 사실은 
QTime 클라스에 복잡성을 더해준다 . 여기에 실례가 있다 . 

1 /* showtime.cpp */ 

2 #include <qdatetime.h> 

3 #include <iostream.h> 

4 #include <unistd.h> 

5 

6 int main(int argc’char **argv) 

1 { 

8 if(argc != 5) { 

9 cout« "Usage: showtime <hh> <mm> <ss> <ms>" 

10 «endl; 

11 return 1; 

12 } 

13 QString hh = argv[ 1 ]; 





14 QString mm = argv[2]; 

15 QString ss = argv[3]; 

16 QString ms = argv[4]; 

17 QTime qtime(hh.toInt(),mm.toInt(), 

18 ss.toInt(),ms.toInt()); 

19 if(!qtime.isValidQ) { 

20 cout« "Invalid time” « endl; 

21 return 2; 

22 } 

23 

24 cout« "Time: " « qtime.toString() « endl; 

25 cout« "hh:mm:ss.ms: " « qtime.hour() « 

26 « qtime.minute() « « qtime.second()« 

27 « qtime.msec() « endl; 

28 

29 qtime.start(); 

30 cout« ’’Start time: ’’ « qtime.toString() « endl; 

31 sleep(2); 

32 int milliseconds = qtime.restart(); 

33 cout« "Restart time: " « qtime.toString() 

34 « " (after ’’ « milliseconds « " milliseconds)" 

35 «endl; 

36 for(inti=0; i<5; i++) { 

37 cout« "Elapsed: ’’ « qtime.elapsed()« endl; 

38 sleep(l); 

39 } 

40 

41 return 0; 

42} 

이 프로그람의 출력은 다음과 갈다 . 

Time: 15:04:22 
hh:mm:ss.ms: 15:4:22.431 
Start time: 08:42:07 

Restart time: 08:42:09 (after 2010 milliseconds) 

Elapsed: 1 
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Elapsed: 1010 
Elapsed: 2020 
Elapsed: 3030 
Elapsed: 4040 

QTime 구성자는 ms(0 〜 999 ) 로 된 초의 소수부인 4 번째 인수를 가지고있다 . 4 번째 인수는 
선택적이고 기정값은 0 이다 . 시 , 분，초에 대하여 범위밖의 수를 입력하는것을 피하기 위하 
여 QTime 객체를 사용하기전에 시간이 정확한가를 isValid () 를 호출하여 확인해야 한다 . 

29 행의 start () 메쏘드는 2 가지 일을 한다 . 즉 현재시간을 가지고 QTime 객체를 적재하고 
경 과시 계값을 0 으로 설정한다 . 또한 정 적메쏘드 currentTimeO 을 포함하는 새로운 QTime 객체 
를 만들수 있다 . 

QTime qtime = QTime: :currentTime(); 

32 행의 restart () 호출은 또한 현재시간으로 QTime 객체를 설정하고 경과시계를 기동하고 
경과시계의 값을 돌려주는데 이것은 start() 혹은 res 切 rtO 의 마지막 호출후에 ms 의 값이다 . 출 
력으로부터 알수 있는것처럼 경과시간은 2s(2000ms ) 에다가 값을 현시하는데 걸리는 추가시 
간인 10ms 값을 더한 값이다 . 

36 행에서 시작하는 순환은 elapsed () 를 반복 호출하고 Is 동안 정지한다 . 출력으로부터 경 
과시간이 증가하고있고 경과시계를 읽고 현시하는데 10ms 걸린다는것을 알수 있다 . 

알아두기 : 경과시계는 24h 동안만 동작하고 그때 자동적으로 0 으로 재설정된다 . 또한 
QTime 의 현재시간은 콤퓨터의 체계시계에 기초하므로 다른 방법으로 체계시계를 변 
경 하면 경 과시 계 에 영 향을 미 친 다 . 

2 가지 메쏘드를 사용하여 미래 또는 과거로 시간을 조절할수 있다 . 그것들은 새로운 시 
간값을 포함하는 새로운 QTime 객체를 만들고 호출한다 . 

QTime qtime2 = qtime.addSecs(int seconds); 

QTime qtime2 = qtime.addMSecs(int milliseconds); 

부의 값은 시간을 과거로 돌리고 정의 값은 미래로 넘긴다 . 시간에 충분한 값을 더하거 
나 덜어서 자정을 넘길수 있다 . 실례로 현재시간이 23:59:45 일 때 30s 를 더하면 결과는 
00:00:15 이다 . 

다음의 비교연산자들은 두 시간들사이의 관계를 결정한다 . 
if(timel = time2)... 
if(timel != time2)... 
if(timel < time2)... 
if(timel > time2) ... 
if(timel <= time2)... 
if(timel >= time2) ... 
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제 5 절. QDateTime 클라스 

QDateTime 클라스는 근본적으로 QDate 클라스와 QTime 클라스를 결합한것으로서 두 클라 
스를 하나로 취급하는 메쏘드들을 가지고있다 . 다음 실례는 QDateTime 클라스에서 쓰이는 기 
본조작을 보여준다 . 

1 /* showtime.cpp */ 

2 #include <qdatetime.h> 

3 #include <iostream.h> 

4 #include <time.h> 

5 

6 int main(int argc’char **argv) 

1 { 

8 time_t bintime; 

9 

10 QDate qdate(2002,5,12); 

11 QTime qtime(04,32,58); 

12 QDateTime dt(qdate,qtime); 

13 if(!dt.isValid()) { 

14 cout« ’’Invalid QDateTime" « endl; 

15 return 2; 

16 } 

17 

18 cout« ’’Date and Time: ’’ « dt.toString() « endl; 

19 QDate d = dt.date(); 

20 cout« ’’Date: ’’ « d.toString()« endl; 

21 QTime t = dt.time(); 

22 cout« "Time: ’’ «t.toString()« endl; 

23 

24 QDateTime current; 

25 bintime = time((time_t *)0); 

26 current. setT imet(bintime); 

27 cout« "Current date and time: ’’ 

28 « current.toString()« endl; 

29 cout« "Days between: " 

30 « current.daysTo(dt) « endl; 




31 cout« ’’Seconds between: ’’ 

32 « current.secsTo(dt)« endl; 

33 

34 return 0; 

35} 

이 프로그람의 출력은 다음과 갈다 . 

Date and Time: Sun May 12 04:32:58 2002 
Date: Sun May 12 2002 
Time: 04:32:58 

Current date and time: Wed Jun 28 09:51:26 2000 
Days between: 683 
Seconds between: 58992092 

10 〜 12 행은 QDate 와 QTime 두 객체를 사용한 QDateTime 객체의 구성을 보여준다 . 오직 
QDate 객체만 요구하는 구성자도 있는데 그것은 내부적으로 00:00:00 으로 설정된 QTime 객체 
를 구성하다 . 

QDate 객 체 는 19 행 에 서 보여 준것 처 럼 date() 호출에 의해 엄 을수 있다 . 새 로운 QDate 객 체 
를 삽입하는데 사용하는 setDateO 메쏘드도 있다 . 같은 일은 timeO 메쏘드 (21 행에서 보여준것 
처럼)와 setTime() 을 가지는 QTime 객체에서도 가능하다 . 

시 간과 날자값들을 모두 32bit 체계시 간값으로 설정할수 있는데 이 것은 1970 년 1 월 1 일 
부터의 경과초수이다 . 25 행에서 timeO 함수에 대한 체계호출은 값을 돌려주며 26 행에서 
QDateTime 의 setTime_t() 메 쏘드호출은 QDateTime 객 체 의 날자와 시 간을 설 정 한다 . 

30 행의 daysTo() 호출은 두 날자사이의 날자수를 돌려준다 . 마찬가지로 32 행의 secsToO 호 
출은 갈은 시 간기 간을 위한 초수를 돌려 준다 . 

다음의 비교연산자들은 두 시간점사이의 관계를 결정한다 . 
if(datetimel == datetime2)... 
if(datetimel != datetime2)... 
if(datetimel < datetime2)... 
if(datetimel > datetime2)... 
if(datetimel <= datetime2)... 
if(datetimel >= datetime2)... 




제 6 절. 파일에 써널기 

다음 실례는 QFile 객체를 사용하여 새로운 파일을 만들고 거기에 2 행의 본문을 써넣는다 . 

1 /* writefile.cpp *| 

2 #include <qfile.h> 

3 

4 int main(int argc’char **argv) 

5{ 

6 char linel[] = "The first line\n M ; 

7 char line2[] = ’’The second line\n"; 

8 

9 QFile qfileC'rwfile.txt ")； 

10 if(qfile.open(IO_WriteOnly)) { 
for(int i=0; i<strlen(linel); i++) 

qfile.putch(line 1 [i]); 
for(int i=0; i<strlen(line2); i++) 
qfile.putch(line2[i]); 
qfile.close(); 

18 return 0; 

19} 

9 행의 구성자는 디스크구동기의 참고를 만들지 않고 QFile 객체를 만든다 . 이 점에서 파 
일은 존재할수도 존재하지 않을수도 있다 . 

알아두기 : QFile 클라스는 QIODevice 클라스를 계승하므로 입력과 출력에 사용될수 있다 . 
대체로 QDataStream 이나 QTextStream 객체를 사용하는것은 QFile 객체를 직접 사용하는 
것보다 간단한다 . 

W 행의 openO 메쏘드는 파일을 써넣기전용으로 열고 성공이면 TRUE 를 돌려주고 실패이면 
FALSE 를 돌려준다 . 파일을 써넣기전용으로 여는 경우 파일이 존재하지 않으면 새로 만들고 길 
이를 0 으로 설정한다 . 파일열기방식은 표 16-1 에 보여준다 . 이 기발들은 OR 연산자에 의해 결합 
할수 있다 . 실례로 완충없이 써넣기 위하여 파일을 IO_Raw|WriteOnly 로서 열수 있다 . 


표 16-1. 파일을 여는데 사용할수 있는 방식들 


방식 

설명 

IORaw 

파일이 완충없이 열린다 . 기정은 완충기를 사용하는것이다 . 

IOReadOnly 

파일이 읽기용으로 열린다 . 파일이 존재하지 않으면 창조된다 . 
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IO_WriteOnly 

파일이 써넣기전용으로 열린다 . 파일은 0 길이로 잘리거나 또는 새로운 0 길 

이파일이 만들어진다 . 

IO_ReadWrite 

파일이 읽기 및 써넣기용으로 열린다 . 현존파일은 잘리우지 않는다 . 존재하 

지 않는 파일이 만들어진다 . 

IOAppend 

파일은 써넣기용으로 열리며 다음 써넣기위치는 파일끝이다 . 현존파일은 잘 

리지 않는다 . 존재하지 않는 파일이 만들어진다 . 

IOTruncate 

파일은 0 길이로 잘리운다 . 

IOTranslate 

파일들은 DOS 형 식 으로 량방향으로 변환된다 . 행 바꾸기 문자쓰기 는 복귀 와 

행바꾸기문자를 모두 파일에 써 넣어는다 . 복귀와 행바꾸기문자는 하나의 행 

바꾸기문자로 변환된다 . 


모든 쓰기는 한번에 lbyte 씩 진행된다 . 12 행과 14 행의 putch() 메쏘드는 파일에 한번에 1 
개 문자를 쓴다 . 15 행의 closeO 메쏘드는 써넣기가 수행될 때 호출되여야 하며 이것은 완충기 
의 자료를 디스크에 내보낸다 . 


제7절. 파일의 읽기 

다음 실례는 QFile 객체의 메쏘드들을 사용하여 ASCII 파일로부터 본문행들을 읽어들인다 . 

1 /* readfile.cpp */ 

2 #include <qfile.h> 

3 #include <iostream.h> 

4 

5 int main(int argc,char **argv) 

6 { 

7 char line[80]; 

8 

9 QFile qfile( M rwfile.txt n )； 

10 if(qfile.open(IO 一 Readonly)) { 

11 while(!qfile.atEnd()) { 

12 if(qfile.readLine(line,strlen(line)) > 0) 

13 cout«line; 

14 } 

15 qfile.close(); 

16 } 

17 

18 return 0; 

19} 
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파일은 10 행에서 읽기전용으로 열린다 . 11 행의 메쏘드 atEndO 는 파일끝에 이를 때까지 
FALSE 를 계 속 돌려 준다 . 12 행의 readLineO 호출은 파일로부터 한행 의 본문을 읽 어들여 
line 문자배 렬 에 보관한다 . readLineO 메쏘드는 실제로 읽 어 들인 문자수를 돌려준다 . 읽 어 들이 는 
최대문자수는 둘째 인수 즉 line 배렬의 용량에 의해 결정된다 . 오유가 있으면(또는 파일끝에 
이르면 )-1 이 돌아온다 . 

다른 메쏘드들을 사용하여 QFile 객체를 통하여 직접 파일로부터 자료를 읽을수 있다 . 
문자들은 getchO 를 호출하여 한번에 하나씩 읽을수 있다 . 이 함수는 int 값으로서 
ASCII 문자를 돌려주거나 오유가 있으면 (또는 파일끝에 이르면 ) -1 을 돌려준다 . 다음 메 쏘드는 
본문이 아닌 자료블로크를 읽어 들이 는데 사용된 다 . 



char block[1024]; 

count = qfile.readBlock(block, 1024); 

이 메 쏘드는 파일로부터 직 접 블로크에 1024byte 까지 전송한다 . 돌림 값은 읽어 들인 
실제바이트수이며 오유조건이 있으면 -1 을 돌려준다 . 

제8절. 파일에 대한 본문출력 

파일에 대한 본문출력은 QTextStream 객체에 출력 QFile 객체를 포함하여 간단히 실현한다 . 
다음 실례는 파일 에 세행의 본문을 써 넣 는다 . 

1 /* streamtextout.cpp */ 

2 #include <qfile.h> 

3 #include <qtextstream.h> 

4 

5 int main(int argc,char **argv) 

6 { 

7 char linel[] = "The first line"; 

8 char line2[] = "The second line，，; 

9 

10 QFile qfile( M rwfile.txt M )； 

11 if(qfile.open(IO_WriteOnly)) { 

12 QTextStream stream(&qfile); 

13 stream «line 1 « endl; 

14 stream «line2 « " and a bit more" « endl; 

15 stream « "Multiplying " « 34 « ，’ by " « 86 

16 « ，， gives ，， « 34*86 « endl; 

17 qfile.closeQ; 


18 } 


419 



19 

20 return 0; 

21 } 

10 행과 11 행에서 QFile 객체가 만들어지고 출력파일이 열린다 . 12 행에서 QFile 객체를 
포함하여 QTextStream 객체를 만든다 . 파일이 출력용으로 열리기때문에 QTextStream 클라스의 
출력메쏘드들과 연산자들은 자료를 실제로 써넣는데 사용될수 있다 . 

이 실례에서 연산자는 흐름에 본문을 출력한다 . 15 행과 16 행의 출력지령들은 

옹근수값들을 문자렬로 변환한 다음 파일에 써 넣는다 . 결과는 다음과 갈다 . 

The first line 

The second line and a bit more 
Multiplying 34 by 86 gives 2924 

제 9 절. 파일로부터 본문읽기 

파일로부터 한 행의 본문을 읽으러면 readLine() 를 사용한다 . 그러나 ASCII 자료를 
읽어들여 문자로부터 수값형식으로 변환하려고 하고 파일형을 알고있다면 QTextStream 을 
사용할수 있다 . 다음은 파일에서 형식화된 본문의 실례이다 . 
orange 255 127 80 72.81 J 

다음 실례는 본문행을 읽어들이고 행의 매 단어를 적 당한 자료형으로 변환한 다음 
입 력행의 형식을 다시 만들어서 자료를 현시한다 . 

1 /* streamtextin. cpp */ 

2 #include <qfile.h> 

3 #include <qtextstream.h> 

4 #include <iostream.h> 



9 int r; 

10 int g; 

11 int b; 

12 double percent; 

13 char code; 

14 


15 QFile qfile( M strext.txt M )； 

16 if(qfile.open(IO_ReadOnly)) { 

17 QTextStream stream(&qfile); 
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18 stream » name; 

19 stream » r » g » b; 

20 stream » percent; 

21 stream » code; 

22 cout« name « " " 

23 « r « ，， " « g « ，’，’ « b « " " 

24 « percent« " " « code « endl; 

25 qfile.close(); 

26 } 

27 


28 return 0; 

29 } 

파일은 15 행과 16 행에서 QFile 객체로서 읽기전용으로 열 린다 . QTextStream 객체는 
17 행에서 QFile 의 용기로서 만들어진다 . 18 행의 >>연산자는 공백이 나타날 때까지 모든 
문자들을 읽어 들이 고 name 이 라는 QStting 객 체 에 그것 들을 보관한다 . 19 행 에 서 하나의 
명령문에 의해 3 개의 int 값을 읽어들인다 . 이 값들은 3 개의 명령문에 의하여 읽어들일수 
있는데 간단히 >>연산자들을 리용하여 1 개 명 령문으로 읽어들일수 있다 . 20 행과 21 행 에서 
double 과 char 값들을 읽어들인 다음 22 〜 24 행에서 원래의 입 력행이 표준출력 에 다시 
표시된다 . 


요 약 

이 장에서 설명한 클라스들은 모두 매우 쓸모있다 . 어떠한 크기의 프로그람이라도 이 
장에서 설명한 거의 모든것을 요구할것이다 . 이 장에서는 다음과 갈은것을 설명하였다 . 

• QString 클라스들은 매우 유연하고 다른 클라스에 의 해 많이 사용되 며 (가와 
KDE 쏘프트웨어개발에서 가장 기초적 인 클라스들중의 하나이다 . 

•모든 클라스들은 QObject 를 계승하므로 모든 객체에서 사용할수 있는 내부시계가 
있다 . 그것은 기동하고 정지할수 있고 지정된 간격으로 실행되도록 설정할수 있다 . 그것은 
사건을 발생 하고 끝날 때 프로그람에 통지한다 . 

• 클라스 QDate, QTime 그리고 QDateTime 는 달력과 시간계산에 사용할수 있는 많은 
메쏘드들을 제공한다 . 

• QFile 객체는 파일에 대하여 량방향으로 임의의 종류의 자료를 읽고쓰는데 사용될수 있다 . 

• QTextStream 객체는 파일에 대하여 량방향으로 형식화된 자료를 읽고 쓰는데 사용될수 있다 . 
다음 장은 유니 코드와 QChar 클라스에 대 하여 설명한다 . QChar 클라스는 이 장에서 

설명한 QString 클라스와 같이 기 초적 인 클라스이 다 . Qt 와 KDE 의 문자털들과 
문자렬조작기능들이 유니코드에 기초하고있으므로 응용프로그람에서 복합변환은 매우 
단순한 과정이다 . 
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제 17 장. 국제화와 환경구성 

학습내용 

원천본문을 번역용으로 만들기 

번역된 문자렬본문의 조작 

한개 응용프로그람을 위한 다국어번역파일의 만들기 

유니코드와 그 조작방법을 리해하기 

응용프로그람을 사용자정 의 하기 위 한 환경 설 정 값들을 정 의 하는 방법 _ 

동의어 il8n 은 i-eighteen-letters-n 의 략어로서 국제화 (internationalization) 라는 단어를 표시 
한다 . KDE 응용프로그람의 국제화판을 아주 간단히 작성하게 하는 편의프로그람들이 KDE 개 
발체 계 에 구축되 였 다 . 프로그람을 작성할 때 몇 가지 기 본규칙 을 따르면 응용프로그람을 위 
한 번역표준비는 간단한 과정으로 된다 . 일단 표를 만들면 프로그람은 실행을 시작할 때 자 
체로 번역한다 . 또한 어떤 번역을 임의의 다른 번역으로 쉽게 넘 길뿐아니 라 앞으로 쏘프트 
웨어에 대한 변경을 동반하는 번역문의 갱신을 편리하게 해주는 봉사프로그람들도 있다 . 

또한 이 장에서는 매개 사용자가 응용프로그람을 사용자정의할수 있게 하는 환경구성파일 
설정방법을 설명한다 . 이 파일들을 대역적으로 관리할 때 모든 사용자는 같은 환경구성을 얻으 
며 국부적으로 고려할 때 매개 사용자는 개별적인 환경설정값들을 가지고 있을수 있다 . 

제1절. 번역가능한 음용프로그람 

실 행 시 에 다국어 로 번 역할수 있는 KDE 응용프로그람은 아주 간단히 만들수 있다 . 현시 
하거나 인쇄하려는 본문을 선언할 때 몇가지 규칙을 준비하고 응용프로그람에서 번역파일의 
존재 에 대하여 검사함으로써 응용프로그람이 자체로 임 의의 언어로 번역할수 있다 . 

다음의 실례는 응용프로그람을 작성하고 번역파일들을 만드는 방법을 보여준다 . 

TriLang 머 리 부파일 

I /* trilang.h */ 

2#ifndefTRILANG_H 

3 #define TRILANG_H 

4 

5 #include <qwidget.h> 

6 #include <qlabel.h> 

7 

8 class TriLang: public QWidget 

9{ 

10 Q_OBJECT 

II public: 






12 TriLang(QWidget *parent=0,const char *name=0); 

13 private: 

14 QLabel *label; 

15 enum ButtonChoice { Rock, Paper, Scissors, 

16 Clear, Exit}; 

17 QString empty String; 

18 private slots: 

19 void slotButton(int ID); 

20 }; 

21 

22 #endif 

이 머 리부파일은 제 일웃준위 창문으로 표시하려는 TriLang 창문부품을 정의한다 . 여기 에 
는 어떤 단추를 늘렀는가를 결정하는데 사용되는 렬거값정의도 있다 . 

현시하려는 모든 문자렬은 실제로 번역을 실행하는 tr() 메쏘드호출내에서 선언된다 . 이 
실례에서 언어코드를 지령행에서 지정하면 그 이름에 의해 파일을 읽으러고 한다 . 본문을 
발견하면 그것을 번역한다 . 본문을 발견하지 못하면 통보창문을 펼치고 프로그람은 번역없 
이 계속 실행된다 . 

TriLang 

1 /* trilang.cpp */ 

2 #include <kapplication.h> 

3 #include <qlayout.h> 

4 #include <qhbuttongroup.h> 

5 #include <qpushbutton.h> 

6 #include <qmessagebox.h> 

7 #include <qfileinfo.h> 

8 #include ’’trilang.h" 

9 

10 int main(int argc’char **argv) 

11 { 

12 KApplication app(argc,argv, "trilang"); 

13 

14 QString lang = argv[l]; 

15 QString langFile = "trilang_" + lang + 

16 QFilelnfo finfo(langFile); 

17 if(finfo.exists()) { 







18 QTranslator *qtranslator = new QTranslator(0); 

19 qtranslator->load(langFile, ".; 

20 app.installTranslator(qtranslator); 

21 } else { 

22 QMessageBox: : waming(0, ’’Language File", 

23 "Unable to open language file ’’ + langFile); 

24 } 

25 

26 TriLang *trilang = new TriLang(); 

27 trilang->show(); 

28 app.setMainWidget(trilang); 

29 return app.exec(); 

30} 

31 

32 TriLang :: TriLang(QWidget *parent,const char *name) 

33 : QWidget(parent,name) 

34 { 

35 QPushButton *button; 

36 QVBoxLayout * layout = new QVBoxLayout(this,5); 

37 

38 QHButtonGroup * group = new QHButtonGroup(this, "group"); 

39 button = new QPushButton(tr("Rock M ),group); 

40 group->insert(button,Rock); 

41 button = new QPushButton(tr( n Paper n ),group); 

42 group->insert(button,Paper); 

43 button = new QPushButton(tr( M Scissors"),group); 

44 group->insert(button,Scissors); 

45 button = new QPushButton(tr( n Clear M ),group); 

46 group->insert(button,Clear); 

47 button = new QPushButton(tr("Exit n ),group); 

48 group->insert(button,Exit); 

49 connect(group,SIGNAL(clicked(int)), 

50 this,SLOT (slotButton(int))); 

51 layout->addWidget(group); 

52 
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53 emptyString = tr("-0- n ); 

54 label = new QLabel(emptyString,this); 

55 label->setAlignment(AlignVCenter | AlignHCenter); 

56 layout->addWidget(label); 

57 

58 resize(10,10); 

59 layout->activate(); 

60} 

61 void TriLang: : slotButton(int ID) 

62 { 

63 switch(ID) { 

64 case Rock: 

65 label->setText(tr("Rock breaks scissors")); 

66 break; 

67 case Paper: 

68 label->setText(tr("Paper covers rock")); 

69 break; 

70 case Scissors: 

71 label->setText(tr( M Scissors cut paper")); 

72 break; 

73 case Clear: 

74 label->setT ext(empty String); 

75 break; 

76 case Exit: 

77 kapp->exit(0); 

78 } 

79} 

14 〜 16 행은 지령행에서 주어진 코드로부터 번역파일이름을 구성한다 . 이것은 보통 2 문 
자코드이다 . 실례로 도이월란드어일 때 de, 영어일 때 en 을 들수 있지만 반드시 그렇게 이름 
을 달 필요는 없다 . 그러나 많은 응용프로그람들은 다음에 제시하는 명명관례를 따른다 . 즉 
웅용프로그람이름 , 밑줄 , 2 문자언어코드 그리고 qm 의 뒤붙이가 붙는다 . 그러므로 자기의 응 
용프로그람이 같은 일을 할 때 보통 주의해 야 한다 . 

17 행 은 파일 이 존재 하는가를 결정 한다 . 그것 이 존재 하면 18 행 에서 QTranslator 객 체 가 만 
들어진다 . QTranslator 객체는 번역표들을 적재하고 포함할수 있다 . 일단 QTranslator 가 적재되 
면 findO 메 쏘드를 리 용하여 알려 진 단어 와 구들의 모임 을 번 역한다 . 19 행 의 load 。 메 쏘드는 



지령행에 의해 선택된 파일에 보관된 번역표들을 읽어들인다. 20행의 instellTranslatorO 호출은 
새로운 (^ Translator 를 응용프로그람의 모든 문자렬들을 번역하는데 사용하는것으로 설정한다. 

번역파일이 없으면 22행의 QMessageBox 가 사용자에게 통지되고 프로그람은 실행을 계 
속한다. 번역파일을 생략해도 프로그람을 실행할 때 오유는 없다. 그것은 정상적으로 실행되 
지만 어떠한 번역도 없다. 

수평단추그롭은 38행의 TriLang 구성자에서 생성 된다. 창문부품에는 내부이 름 group 가 할 
당되고 이것은 번역되지 않는다. 내부사용을 위한 문자별들을 번역할 필요가 없다. 번역해야 
할 문자렬들은 오직 현시되는 문자별이다. 

39행 에 서 QPushButton 이 창조된 다. 단추의 표식 본문을 “ Rock ” 로 정 의 하고 번 역할수 있 
도록 메쏘드 tr () 의 인수로 넘긴다. 仕 () 안에서 정의되므로 이 문자렬은 번역된다. 41~47행에서 
다른 단추들의 표식본문들도 모두 같은 방법으로 정의된다. 

53행에서 emptyS 仕 ing 이라는 QString 객체에는 초기값이 할당된다. 또한 인용표안의 상수 
문자렬은 tr () 에 넘기는 인수로 정의되므로 그것도 역시 번역된다. 

61행 에 서 시 작하는 slotButton () 메 쏘드는 본문을 여 러 값들중 하나로 설 정한다. 매 개 경 
우에 상수문자렬은 tr () 호출안에서 정의된다. 75행에서 setText () 호출은 emptyString 을 사용하지 
만 거기에 보관된 값은 이미 번역되였으므로 다시 번역되지 말아야 한다. 

파일을 지정하지 않거 나 존재하지 않는 파일을 지정 함으로써 프로그람을 번 역없이 실 
행하면 창문은 그림 17-1 과 같아진다. 



그림 17-1. 번 역 파일없 이 TriLang 의 실 행 

갈은 응용프로그람이 완전히 다르게 표시되는 2개의 번역파일이 있다(다음 절들에서 자 
세히 설명한다). 번 역 파일은 현시 된 모든 문자렬을 변경 하지 말아야 한다. 

그림 17-2 는 두세개의 번역된 문자렬을 가진 같은 창문을 보여준다. 



그림 17-2. 최소번역을 가지고 TriLang 의 실행 
현시 된 모든 문자렬을 변경할수 있다. 그림 17-3 은 번 역 파일 에서 사용할수 있는 모든 
문자렬을 변경한 결과를 보여준다. 
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그림 17-3. 완전번역을 가진 TriLang 실행 

제2절. 번역할수 있는 문자렬의 선언 

번역파일의 적재외에 모든 응용프로그람에 대하여 번역하려는 문자렬들이 tr () 메쏘드의 
인수로 정의되였는가 확인하여야 한다. trO 메쏘드는 QObject 를 계승하는 모든 객체에 사용할 
수 있다. 이것은 모든 QWidget 객체들을 포함하므로 현시가능한 본문과 작업하는곳에서는 거 
의 어디서나 사용할수 있다. 

tr () 메쏘드는 QString 객체를 돌려보내므로 보통 QStting 을 사용하는곳에서는 tr () 를 사용 
할수 있다. 실례로 다음과 같이 QLabel 을 정의한다고 하자. 

QLabel *label = new QLabel (" Select ", this ); 

그것을 번역하기 위하여 tr () 호출에서 인수로서 문자렬을 포함하도록 코드를 변경한다. 

QLabel *label = new QLabel (仕 (" Select "), this ); 

仕 () 메쏘드호출이 없을수 있다. 仕 () 에는 QObject 로부터 계승하는 객체외의 문자렬정의가 
있다. 그러므로 명백한 해결책은 다른 위체트의 tr () 를 러용하는것이다. 실례로 함수안에서 
작업하는데 후에 사용할 표식자를 만들려고 한다면 다음과 같이 QLabel 의 부모창문부품을 
사용한다. 

QLabel *label = new QLabel ( parent :: tr (" Select "), parent ); 

정적문자렬을 정의하여야 한다면 두 마크로를 사용한다. 하나는 클라스의 메쏘드안에서 
사용하기 위한것이다. 

TriLang : : fs 仕0 { 

static char * f = QT _ TR _ NOOP("String text ")； 

} 

실례로 QT _ TR_NOOP 마크로는 실행가능코드를 포함하지만 그것은 원천코드의 문자렬을 
번 역 용으로 표식한다. 이 문자렬은 그것 이 TriLang 클라스의 성 원인 메쏘드안에서 정 의되 므로 
그 클라스의 성원으로 번역된다. 클라스의 밖에서 정적선언을 할 필요가 있다면 약간 다른 
마크로가 요구된다. 

static char * f = QT _ TRANSLATE _ NOOP (" TriLang","String text ")； 

정의가 클라스밖에 있으므로 클라스이름도 요구된다. 이것은 이 장의 나중에 설명하는 
것처럼 클라스이름이 번역과정에 대한 건으로서 내적으로 사용되기때문이다. 어떠한 클라스 
의 이름이든 사용할수 있다. 또한 이 마크로는 본문을 번역용이라고 표식하는것외에 다른 
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일은 하지 않는다. 


제3절. 번역된 문자렬에 대한 조작 

어떠한 방법으로 문자렬들을 형식화하려고 한다면 항상 QS 仕 ing 을 사용해야 한다. 현시 
가능한 문자렬들을 조작하는데 절대로 char 배렬이나 QCString 클라스를 사용하지 말아야 한다. 
개별적인 문자들을 리용하려 한다면 유니코드문자를 리용하는데 필요한 모든 기능을 제공하 
는 QChar 를 사용하여 야 한다. 

자료를 문자렬로 형식화하려면 QS 仕 ing 의 arg () 성원함수를 사용하여야 한다. 실례로 int 
와 double 값을 리용하여 다음의 행을 현시하는 경우를 고찰하자. 

Step 3 is 34.6 percent complete . 

다음은 이 문자렬을 형식화하는 방법이다. 

QString report ; 

report = tr("Step %1 is %2 percent complete . "). arg ( step ). arg ( percent ); 

이렇게 번역을 하면 제시된 문자렬은 다음과 갈다. 

"Step %1 is %2 percent complete . " 

번역은 값들을 다른 순서로 배치되도록 요구할수 있다. 즉 필요하다면 값들을 다시 배 
렬할 권한을 번역기에 줄수 있다. 실례로 명령문은 다음과 같이 간단히 쓸수 있다. 
’’Completion now at %2 percent of step %1" 

제 4 절. 번역파일의 구축 

일단 응용프로그람을 작성하였고 모든 문자렬들이 번역용으로 적당히 정의되였다면 번 
역파일들을 구축할수 있다. 

frndtr 편의프로그람은 번역하려는 모든 문자렬을 포함하는 파일을 만드는데 사용된다. 
이 장에서 사용하는 실례에 영어로 번역되지 않은 판이 있고 2개의 다른 판들은 이 실례를 
위해 제안되였다. 다음 지령을 입력하여 초기파일들을 만든다. 
findtr *.cpp * 上 > trilang.po 
cp trilang.po trilang en.po 
cp trilang.po trilang _ sh.po 
cp trilang.po trilang sl.po 

3 개의 모든 번역파일들은 꼭같은 내용으로 시작된다. findtr 편의프로그람은 선두에 머리 
부정보를 가지는 파일을 만들며 파일의 동작부는 다음과 같다. 

#: trilang . cpp :53 
msgid " TriLang ::-0 - n 
msgstr "" 
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#: trilang . cpp :45 
msgid " TriLang :: Clear " 
msgstr ’"， 

#: trilang . cpp :47 
msgid " TriLang :: Exit " 
msgstr "" 

#: trilang . cpp :68 

msgid " TriLang::Paper covers rock " 
msgstr ”" 

#: trilang . cpp :41 
msgid " TriLang :: Paper " 
msgstr "" 

#: trilang . cpp :65 

msgid ’’ TriLang::Rock breaks scissors ’’ 
msgstr "" 

#: trilang . cpp :39 
msgid " TriLang :: Rock " 
msgstr "" 

#: trilang . cpp :71 

msgid " TriLang::Scissors cut paper ’’ 
msgstr 

#: trilang . cpp :43 
msgid " TriLang :: Scissors '* 
msgstr "" 

msgid 문자렬은 번역을 찾는데 쓰이는 문자렬이다. 매개 msgid 항목은 원시프로그람에 나 
타나는 문자렬이 다. 매개 문자렬뒤 에는 그것을 포함하는 클라스의 이 름과 2개의 두점 이 놓 
인다. msgstr 는 번 역문자렬을 포함한다. 이 실례 에서처 럼 번역하려는 문자렬이 없으면 번 역은 
진행되지 않는다. 모든 파일들은 같은 내용으로 시작되며 오직 msgstr 항목들만 변경되여야 
한다. 실례로 파일 trilang _ sh . po 는 다음과 같은것을 포함한다. 

#: trilang . cpp :53 
msgid " TriLang ::-0 -“ 
msgstr ，，***” 

#: trilang . cpp :45 
msgid n TriLang :: Clear M 
msgstr " Erase ” 
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#: trilang . cpp :47 
msgid " TriLang :: Exit M 
msgstr ’"， 

#: trilang . cpp :68 

msgid " TriLang::Paper covers rock " 
msgstr "Sheet covers rock " 

#: trilang . cpp :41 
msgid n TriLang :: Paper " 
msgstr " Sheet " 

#: trilang . cpp :65 

msgid " TriLang::Rock breaks scissors " 
msgstr "’， 

#: trilang . cpp :39 
msgid ’’ TriLang :: Rock " 
msgstr "" 

#: trilang . cpp :71 

msgid " TriLang::Scissors cut paper ' 1 
msgstr "Scissors cut sheet ' 1 
#: trilang . cpp :43 
msgid " TriLang :: Scissors M 
msgstr ’"， 

클라스이름은 msg 的•에서 번역된 문자렬의 부분으로 포함되지 않는다. 그것은 오직 번 
역과 문자렬을 대조하기 위한 문자렬로서만 msgid 의 부분으로 포함된다. 또한 번역하지 말 
아야 할 항목은 포함할 필요가 없다. 

일단 .…파일들을 만들고 편집하였으면 그것들을 응용프로그람이 사용하는 .qm 파일들로 
바꾸어야 한다. 편의프로그람 msg 2 qm 은 실례의 3개 파일을 다음과 같이 변환한다. 
msg 2 qm trilang _ en.po trilang en.qm 
msg 2 qm trilang _ sh.po trilang _ sh.qm 
msg 2 qm trilang _ sl.po trilang sl.qm 

프로그람을 실행할 때 적당한 .qm 파일을 읽어들이고 리용한다. 어떠한 방법으로 번역을 
변경하려면 간단히 .po 파일을 편집하고 그것으로 새로운 .qm 파일을 만든다. 

자기 프로그람을 변경하여 거기에 포함된 문자별들을 변경하면 msg 2 qm 을 기동하지 말 
아야 한다. mergetr 편의프로그람은 이미 수행한 작업을 보관하고 거기에 정보를 결합할수 있 
게 하므로 새로운 .…파일을 생성하고 다음과 같이 변경을 결합해야 한다. 
findtr *.cpp *.h > trilang.po 




mergetr trilangen.po trilang.po 
mergetr trilangsh.po trilang.po 
mergetr trilang _ sl.po trilang.po 

이것은 이전의 모든 정보와 결합된 변경 이 포함되 여있는 3개의 .po 파일을 제공한다. 항 
목들중 하나가 원래의 코드에서 변경되여 이전에 번역한 문자렬에 대한 변경을 요구한다면 
이전의 번역은 주해로서 포함된다. 

제5절. 유니코드와 QChar 

KDE 와 (가의 표준문자모임은 유니코드이다. 매개 문자는 16 bit 로 표시된다. 이것은 문자 
가 65,536개 있을수 있다는것을 의미한다. 이것은 세계의 모든 언어의 문자들을 다 포함할수 
있는 충분한 공간이다. 

알아두기: 유니코드는 거기에 포함된 모든 문자들은 앞으로도 당분간 그대로 리용할 
것이다. 심지어 유니코드에는 완전한 Klingon 자모들도 포함한다. 그러나 그리 멀지 않 
은 미래에 새로운 문자들을 포함시키기 위하여 매개 유니코드문자를 32 bit 로 확장할 
필요가 있다. 

0〜127의 유니 코드값들은 ASCII 와 같은 문자를 표시한다(거 기 서 매 개 문자는 0〜127범 
위의 값이다). 이것은 ASCII 에서 유니코드에로의 문자변환을 하지만 유니코드로부터 ASCII 
에로의 변환은 약간의 변경을 요구한다. 이것은 ASCII 로 프로그람을 작성하고 필요할 때 유 
니코드로 자동변환하게 한다. 

본문을 리 용할 때 흔히 공백，점，대 소문자 그리 고 다른 문자속성 들을 인식할 필요가 
있다. ASCII 에는 문자가 적으므로 간단하다. 유니코드는 새로운 문자를 언제나 추가할수 있 
다. 이것을 취급하기 위하여 매개 유니코드문자에는 속성들의 모임이 할당된다. 프로그람은 
문자의 몇가지 구체적인 속성을 검사할수 있고 말하자면 그것이 대문자인가, 수자인가를 결 
정할수 있다. 매개 범주는 2문자코드로 표시된다. 표 17-1 에서는 표준범주를 보여준다. 표준 
범주는 언어학에 기원을 둔 문자의 기본본성에 대한 서술이다. 표 17-2 에서는 정보범주를 보 
여준다. 이것은 기본적인 언어학적기원외에 문자에 대한 설명이다. 


표 17-1. 유니코드표준범주 
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이것들은 모두 16 bit 유니코드문자로서 넘긴 수값을 리용한다. 어떤 인수도 제공되지 않 
으면 유니코드 null 문자 0 x 0000 이 사용된다. 8 bit 값을 받아들이는 2개 구성자는 그 값이 
ASCII 문자라고 가정 하고 맨 웃자리 바이 트를 0으로 설 정한다. 2개 의 8 bit 값을 요구하는 구성 
자는 제 일 아래 자리 바이 트의 cell 값을 사용하며 제 일웃자리 바이 트로서 row 를 리 용한다. 

다음 Boolean 메쏘드들은 문자의 기본적 인 특성을 결정하는데 쓰인다. 
bool isDigit () const 
bool isLetter () const 
bool isLetterOrNumber () const 
bool isMark () const 
bool isNull () const 
bool isNumber () const 
bool isPrint () const 
bool isPunct () const 
bool isSpace () const 

매개 메쏘드는 문자의 특성을 보고 돌림값을 결정한다. 실례로 문자가 어떠한 언어의 
수자이면 즉 표 17-1 로부터 Number_Letter 또는 Number _ Other 이면 isNumber () 는 TRUE 를 돌 
려준다. 

자세 한 정 보를 요구한다면 다음 메 쏘드는 표 17-1 과 17-2 에 서 이 름지어 진 매 개 형 들의 
항목을 포함하는 렬거형 을 돌려 준다. 

Category category。const 

가장 일반적인 문자변환은 대소문자의 변환으로서 다음의 메쏘드들로 수행할수 있다. 

QChar lower () const 
QChar upper () const 

다음 메쏘드들은 유니코드문자의 수값을 돌려주는데 사용한다. 
ushort unicode () const 
char latinl () const 
uchar & cell () 
uchar cell () const 
uchar & row () 
uchar row () const 
int digitValue () const 

unicode () 메쏘드는 문자의 16 bit 값을 돌려준다. latinlQ 메쏘드는 ASCII 문자의 8 bit 값을 돌 
려주며 문자가 ASCII 가 아니면 0을 돌려준다 . cell 값은 제일아래자리바이트이며 row 값은 제일 
웃자리 바이 트이다. digitValueO 메 쏘드는 문자를 돌려 주지 않으며 문자가 수자이 면 수값을 int 
로서 돌려준다. 




제 6 절. 환경구성 


KConfig 클라스는 프로그람의 한 기동으로부터 다음번 기동할 때까지 환경설정을 보관 
하는데 사용한다. 환경설정은 특별한 형식으로 본문파일에 보관된다. 매개 설정은 마당단어 
와 값의 쌍으로 보관되고 이 쌍들은 그룹들로 나누일수 있다. 다음 실례는 이동하고 크기변 
경할수 있는 창문을 현시 함으로써 이것 이 어떻게 작업하는가 보여주며 지 어 프로쎄스를 멈 
추고 다시 기동할 때 그 크기와 위치를 얻는 방법을 보여준다. 

Remember 머 리 부파일 

1 /* remember.h */ 

2 #ifedef REMEMBER_H 

3 #defme REMEMBER_H 

4 

5 #include < qwidget . h > 

6 

7 class Remember : public QWidget 
8{ 

9 public : 

10 void configure (); 

11 private : 

12 QSize windowSize ; 

13 QPoint windowPosition ; 

14 protected : 

15 virtual void paintEvent(QPaintEvent *); 

16 virtual void resizeEvent(QResizeEvent *); 

17 virtual void moveEvent(QMoveEvent *); 

18 virtual void closeEvent(QCloseEvent *); 

19}； 

20 

21 #endif 

Remember 창문부품은 응용프로그람의 제 일웃준위창문이 다. 12행과 13행 에서 windowSize 
와 windowPosition 값들은 창문에 대하여 계속 갱신되는 위치정보를 보관한다. 

Remember 

1 /* remember.cpp */ 

2 #include < kapplication . h > 

3 #include < kconfig . h > 



4 #include < qpainter . h > 

5 #include < qdir . h > 

6 #include ’’ remember . h ” 

7 

8 int main(int argc,char ** argv ) 

9{ 

10 KApplication app ( argc , argv ,’’ remember ”); 

11 Remember remember ; 

12 remember . configure (); 

13 remember . show (); 

14 app . setMainWidget (& remember ); 

15 return app . exec (); 

16} 

17 void Remember : : paintEvent(QPaintEvent *) 

18 { 

19 QPainter p ( this ); 

20 

21 p . setWindow (0,0,300,300); 

22 p.drawRoundRect(50,50,200,200,30,30 )； 

23 p . setBrush ( QColor ( M white ")); 

24 p . drawEllipse (100,100,100,100); 

25} 

26 void Remember :: resizeEvent(QResizeEvent * event ) 

27 { 

28 windowSize = event -> size (); 

29} 

30 void Remember : : moveEvent(QMoveEvent * event ) 

31 { 

32 windowPosition = event -> pos (); 

33} 

34 void Remember : : closeEvent(QCloseEvent * event ) 

35 { 

36 QString str ; 

37 

38 KConfig *config = 
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39 new KConfig(QDir: : homeDirPath() + ’’/.remember’’); 

40 config->setGroup( n Geometry"); 

41 config->writeEntry( n width n , 

42 str.setNum(windowSize.width())); 

43 config->writeEntry( n height n , 

44 str.setNum(windowSize.height())); 

45 config->writeEntry( n xPosition n , 

46 str. setNum(windowPosition.x())); 

47 config->writeEntry( M yPosition n , 

48 str. setNum(windowPosition.y())); 

49 config->sync(); 

50 delete config; 

51 

52 event->accept(); 

53} 

54 void Remember::configure() 

55 { 

56 int width; 

57 int height; 

58 int x; 

59 int y; 

60 QString str; 

61 

62 KConfig *config = 

63 new KConfig(QDir: : homeDirPath() + ’’/.remember’’); 

64 config->setGroup("Geometry"); 

65 width = config->readNumEntry("width", 100); 

66 height = config->readNumEntry (’’height", 100); 

67 x = config->readNumEntry("xPosition", 10); 

68 y = config->readNumEntry( n yPosition M ,l 0); 

69 

70 windowSize = QSize(width,height); 

71 windowPosition = QPoint(x,y); 

72 


73 resize(windowSize); 



74 move ( windowPosition ); 

75} 

프로그람의 mainO 함수는 8행 에서 시작한다. 그것은 Remember 창문부품을 창조하여 제 일 
웃준위창문으로서 사용한다. 12행 에 창문이 현시되기전에 환경 구성자료를 읽 어들여 창문크기 
와 위치를 설정하기 위한 configureO 메쏘드호출이 있다. 

17행의 paintEvent () 메 쏘드는 QPainter 객체를 사용하여 그림의 크기를 실제 창문크기 에 맞 
게 자동적으로 조절한다. 그러기 위하여 setWindow () 를 호출하여 너비와 높이의 최대값들을 
설 정 하고 그 치 수를 사용하여 도형 으로 직4각형 을 채 운다. 그림 17-4 에서 는 각이한 크기 의 
Remember 창문을 보여준다. 




그림 17-4. 여 러 가지 창문의 크기 와 위 치 기 억 
Remember 창문부품은 현재크기와 장소의 리력을 가지고있다. 26행의 resizeEvent () 메쏘드 
는 창문크기가 변화될 때마다 호출되고 30행의 moveEvent () 는 창문이 이동할 때마다 호출 
된다. 두 메쏘드는 항상 windowSize 와 windowPosition 에 보관된 값을 갱신한다. 

34행의 closeEvent () 메쏘드는 응용프로그람이 닫길 때마다 호출된다. 현재 환경구성설정 
을 보관하기 위하여 사용자의 홈등록부에서 . remember 라는 파일을 열어 KConfig 객체를 만든 
다. 정적 메쏘드 QDir :: homeDirPath () 는 현재사용자의 홈등록부의 완전경로를 돌려주는데 이것 
은 사용자마다 이 프로그람용으로 개 별적 인 환경 구성파일을 가지 고있다는것을 의미 한다. 

40행 의 setGroupO 호출은 환경 구성 정 보를 포함하는 파일 안의 그룹이 름을 지 정 한다. 파일 
에 그룹이 여러개 있을수 있고 같은 마당값은 여러개의 그룹에 나타날수 있다. 임의의 시각 
에 KConfig 객체는 오직 1개의 그룹만 호출할수 있으나 setGroup 을 호출하여 한 그룹에서 다 
른 그룹으로 절환할수 있다. 41〜48행에서 매개 writeEntry () 호출은 환경구성에 단일항목을 써 
넣는다. 매개 항목은 값문자렬과 그것을 발견하는데 사용되는 마당으로 이루어진다. 이 실례 
에 의하여 씌여진 본문은 다음과 갈다. 

[ Geometry ] 

height =170 

width =406 
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xPosition =346 

yPosition =130 

파일에서 그룹이름들은 중괄호에 포함되고 그뒤에 오는 모든 마당-값의 쌍들은 그룹안 
에 있다. 

writeEntry () 메쏘드는 파일에 직접 써넣지 않는다. KConfig 객체가 만들어지면 파일(있다 
면)을 읽고 그로부터 모든 정의를 적재한다. 41〜48행에서 writeEntry () 호출은 간단히 마당-값 
들의 RAM 상주목록을 갱신한다. 그것은 49행에서 sync () 메쏘드호출에 필요하기때문이다. 
sync () 메쏘드는 파일에 모든것을 써넣음으로써 파일자료와 RAM 자료를 동기화한다. 

실제로 응용프로그람이 닫기는것을 방지하는데 closeEventO 를 사용할수 있다. 이 실례에 
서 52행의 accept () 호출은 이 응용프로그람이 닫기요구를 받아들인다는것을 의미하므로 체계는 
실행되지만 창문은 닫긴다. 이 메쏘드를 호출하지 않으면 응용프로그람은 닫기지 않고 기정 
closeEvent () 메쏘드가 간단히 accept () 을 호출한다. 54행의 configure () 호출은 이전 환경구성 설정(있 
다면)을 읽어 들이 고 자료를 사용하여 현재 응용프로그람의 환경 을 구성 한다. KConfig 객체는 62 
행과 63행 에서 만들어지고 closeEventO 에서처 럼 파일로부터 모든 환경구성정보를 읽어들인다. 
64행 의 setGroupO 호출은 자료를 ’’Geom 的 y ” 라는 그룹으로부터 읽어 들인 다. 65〜68행 의 
readNumEntryO 호출에서 마당들이 주어지고 서로 련결된 int 값들을 돌려준다. 호출의 둘째 인수 
는 마당값이 없으면 돌려받은 기정값이다. 함수호출에서 기정값을 줌으로써 오유처리를 간단 
화한다. 마당이 없으면 기정값이 사용된다. 70행과 기행에서 이 값들은 응용프로그람이 닫길 
때 보관된 다 .73 행 과 74행 에 서 resize () 와 move () 호출은 창문자체 의 환경 을 구성 한다. 

요 약 

인터네트의 출현과 쏘프트웨어의 국제적 인 배포와 함께 늘 쏘프트웨어를 언어 에 따라 
이식할수 있게 만드는것이 중요하다. KDE 에 구축된 편의프로그람들은 번역할수 있는 쏘프트 
웨어대면부들을 만들고 유지하는 일을 대단히 쉽게 해준다. 이 장에서는 다음과 갈은 이식 
가능항목들을 론의하였다. 

• QObject 의 tr () 메쏘드에 대한 인수로서 상수문자렬을 포함하면 프로그람을 실행할 때 
문자렬 들을 번 역할수 있 다. 

• 메쏘드밖에서 정적으로 정의된 문자렬들의 번역은 프로그람을 실행할 때 그 문자렬 
들을 번 역용이 라고 표식 하는 특수마크로안에 포함할것 을 요구한다. 

•간단한 편의프로그람들을 리용하여 프로그람의 원천코드를 조사하고 실제번역시에 
작성 자가 편집할 번 역 파일들을 만든다. 그때 이 파일들의 내용을 읽어 들이 고 실제 번 역 메쏘 
드용의 대리들을 만든다. 

•환경구성자료는 환경설정을 그룹들로 구분하고 매개 그룹에 탐색가능한 마당들을 할 
당하는 형식으로 본문파일들에 기 억될수 있다. 

다음 장에 서 는 모든 Qt 창문부품들에 대 하여 간단히 설 명한다. 


439 



제 18 장. 어의 창문부품 


학습내용 

매개 창문부품의 구성자, 필요한 머리부파일，기초클라스들과 파생클라스들, 신호 
와 처리부들, 공개메쏘드들 

매개 창문부품의 자그마한 실례. _ 

창문부품은 현시가능한 창문을 포함하는 클라스이다. 어에서 현시가능한 창문을 가진 
모든 클라스는 QWidget 클라스로부터 창문기능을 계승한다. 

이 장에서는 매개 창문부품에 대하여 머리부파일의 이름, 모든 기초클라스들의 이름, Qt 
와 KDE 의 모든 파생클라스들의 이 름 그리 고 공개메쏘드들, 처 리부，신호, 및 렬거형 들을 제 
시한다. 

매개 창문부품에 적어도 하나의 실례프로그람이 있고 매개 실례는 창문부품의 현시가 
능한 폼을 만든다. 일부 창문부품들은 제 일웃준위창문부품으로서 지 정 하여 설명 하며 기 본창 
문으로 현시 된다. 그러 나 일부 특수창문부품들은 특정한 환경 에 서 포함된다. 


QButton 

이 창문부품은 그 모양을 바꾸고 신호를 발생함으로써 마우스사건에 응답한다. 
머리 부파일 

#include <qbutton.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 
파생 클라스 

KColorButton KDialogBaseButton KDirectionButton 
KDockButtonPrivate KIconButton KKeyButton KTabButton 
KToolBarButton QCheckBox QPushButton QRadioButton 
QToolButton 
구성 자 

QButton(QWidget *parent = 0, const char *name = 0, WFlags f = 0); 

메쏘드 

int accel() const; 

bool autoRepeat() const; 

bool autoResize() const; 

bool focusNextPrevChild(bool next); 

QButtonGroup *group() const; 
bool isDown() const; 





bool isExclusiveToggle() const; 

bool isOn() const; 

bool isToggleButton() const; 

const QPixmap *pixmap() const; 

virtual void setAccel(int); 

virtual void setAutoRepeat(bool); 

virtual void setAutoResize(bool); 

virtual void setDown(bool); 

virtual void setPixmap(const QPixmap &); 

virtual void setText(const QString &); 

ToggleState state() const; 

QString text() const; 

ToggleType toggleType() const; 

처리부 

void animateClick(); 
void toggle(); 

신호 

void clicked(); 
void pressed(); 
void released。; 
void stateChanged(int); 
void toggled(bool); 

렬거형 

enum ToggleType { SingleShot, Toggle, Tristate }; 
enum ToggleState { Off, NoChange, On }; 

7 장에 QButton 창문부품의 실례가 있다 . 

QButtonGroup 

이 창문부품은 수평으로 또는 수직으로 배치된 단추모임의 용기이다 . 
머리 부파일 

#include <qbuttongroup .h> 

기초클라스 

QFrame QGroupBox QObject QPaintDevice QWidget Qt 
파생 클라스 

QHButtonGroup QVButtonGroup 
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구성자 

QButtonGroup(QWidget *parent = 0， const char *name = 0); 

QButtonGroup(const QString &title, QWidget *parent = 0， const char *name = 0); 

QButtonGroup(int columns, Orientation o, QWidget *parent = 0， const char *name = 0); 
QButtonGroup(int columns, Orientation o, const QString &title, QWidget *parent = 0 ， 
const char *name = 0); 

메쏘드 

int count() const; 

QButton *find(int id) const; 

int id(QButton *) const; 

int insert(QButton *，int id = - 1); 

bool isExclusive() const; 

bool isRadioButtonExclusive() const; 

virtual void moveFocus(int); 

void remove(QButton *); 

QButton *selected(); 

virtual void setButton(int id); 

virtual void setExclusive(bool); 

virtual void setRadioButtonExclusive(bool); 

신호 

void clicked(int id); 
void pressed(int id); 
void released(int id); 

이 클라스는 직접 사용되지 않는다. 

7장에 QHButtonGroup 와 QVButtonGroup 의 실례가 있다. 

QCheckBox 

이 창문부품은 검사칸이다. 검사칸은 마우스에 의해 on 과 off 로 절환될수 있고 항상 현 
재 상태 를 현시한다. 

머리 부파일 

#include <qcheckbox.h> 

기초클라스 

QButton QObject QPaintDevice QWidget Qt 

구성자 

QCheckBox(QWidget *parent, const char *name = 0); 
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QCheckBox(const QString &text, QWidget *parent, const char *name = 0) 

메쏘드 

bool isChecked() const; 
void setChecked(bool check); 
void setNoChange(); 
void setTristate(bool y = TRUE); 

QSize sizeHint() const; 

QSizePolicy sizePolicy() const; 

7 장에 QCheckBox 창문부품을 수직 및 수평단추그룹에서 사용하는 많은 실례가 있다. 

QColorDialog 

이 클라스는 사용자가 색을 선택할것을 재촉하는 대화칸을 펼치는데 쓰이는 정적메쏘 
드들의 모임이다. 

머리 부파일 

#include <qcolordialog.h> 

기초클라스 

QDialog QObject QPaintDevice QWidget Qt 

메쏘드 

static QRgb customColor(int); 
static int customCount(); 

static QColor getColor(QColor, QWidget *parent = 0, const char *name = 0); 

static QRgb getRgba(QRgb, bool *ok = 0, QWidget *parent = 0, const char *name = 0); 

static void setCustomColor(int, QRgb); 

다음 실례는 기 정선택 으로서 붉은색을 사용하고 사용자가 그 색을 받아들이거 나 다른 
색을 선택할것을 재촉한다. 대화칸은 그림 18-1 에 보여준다. 

/* showcolordialog.cpp */ 

#include <qapplication.h> 

#include <qcolordialog.h> 
int main(int argc’char **argv) 

{ 

QApplication app(argc,argv); 

QColor seedColor (” red”); 

QColor newColor; 

newColor = QColorDialog: :getColor(seedColor); 
retum(app. exec()); 







그림 18- l.QColorDialog 창문부품 

QComboBox 

이 창문부품은 사용자가 목록으로부터 선택하는데 단추를 사용하며 늘 현재선택항목을 
현시 한다. 

머리 부파일 

#include <qcombobox.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

파생 클라스 

KColorCombo KComboBox KFileComboBox KFileFilter KURLComboBox 

구성자 

QComboBox(QWidget *parent = 0， const char *name = 0); 

QComboBox(bool rw, QWidget *parent = 0， const char *name = 0); 

메쏘드 

bool autoCompletion() const; 
bool autoResize() const; 
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void changeItem(const QString &text, int index); 

void changeItem(const QPixmap &pixmap, int index); 

void changeItem(const QPixmap &pixmap, const QString &text, int index); 

void clearO ； 

int count() const; 

int currentltem() const; 

QString currentText() const; 

bool duplicatesEnabled() const; 

bool eventF ilter(QObj ect * object, QEvent * event); 

void insertItem(const QString &text, int index = - 1); 

void insertItem(const QPixmap &pixmap, int index = - 1); 

void insertItem(const QPixmap &pixmap, const QString &text, int index = - 1); 

void insertStrList(const QStrList &, int index = - 1); 

void insertStrList(const QStrList *, int index = - 1); 

void insertStrList(const char **, int numStrings = - 1, int index = - 1); 

void insertStringList(const QStringList &, int index = - 1); 

Policy insertionPolicy() const; 

QLineEdit *lineEdit() const; 

QListBox *listBox() const; 

int maxCount() const; 

const QPixmap *pixmap(int index) const; 

void removeItem(int index); 

virtual void setAutoCompletion(bool); 

virtual void setAutoResize(bool); 

virtual void setBackgroundColor(const QColor &); 

virtual void setCurrentItem(int index); 

void setDuplicatesEnabled(bool enable); 

virtual void setEnabled(bool); 

virtual void setFont(const QFont &); 

virtual void setInsertionPolicy(Policy policy); 

virtual void setListBox(QListBox *); 

virtual void setMaxCount(int); 

virtual void setPalette(const QPalette &); 

virtual void setSizeLimit(int); 

virtual void setValidator(const QValidator *); 


QSize sizeHintQ const; 
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int sizeLimit() const; 

virtual QSizePolicy sizePolicyO const; 

QString text(int index) const; 
const QValidator *validator() const; 

처 리 부 

void clearEdit(); 
void clearValidator(); 

virtual void setEditText(const QString &); 

신호 

void activated(int index); 

void activated(const QString &); 

void highlighted(int index); 

void highlighted(const QString &); 

void textChanged(const QString &); 

렬거형 

enum Policy { Noinsertion, AtTop, AtCurrent, AtBottom, AfterCurrent, BeforeCurrent }; 

다음 실례는 4 개의 항목을 가지는 QComboBox 를 만든다. 그림 18-2 는 마우스로 목록을 
펼치고 둘째 항목을 선택한 후의 창문부품을 보여준다. 

/* showcombobox.cpp */ 

#include <qapplication.h> 

#include <qcombobox.h> 

const char *list[] = { "First Selection”, "Second Selection”，"Third Selection”，"Fourth Selection” }; 
int main(int argc,char **argv) 

{ 

QApplication app(argc,argv); 

QComboBox *combobox = new QComboBox(); 

combobox->insertStrList(list,4); 

combobox->show(); 

app. setMainW idget(combobox); 

retum(app.exec()); 



그림 18-2. 4 개 항목을 가지 는 QComboBox 창문부품 
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QDialog 

이 창문부품은 대화칸의 기초클라스이다. 기초클라스로 사용할수 있으며 초기화할 때 
창문부품들을 채워넣어 대화칸을 동적으로 구성할수 있다. 

머리 부파일 

#include <qdialog.h> 

기 초클라스 

QObject QPaintDevice QWidget Qt 

파생 클라스 

KAboutDialog KAboutKDE KBugReport KColorDialog KCookieWin KDialog KDialogBase KEdFind 
KEdGotoLine KEdReplace KEditToolbar KFileDialog KFileDialogConfigureDlg KFontDialog KIconDial 
og 

KKeyDialog KLineEditDlg KOpenWithDlg KPasswordDialog KTextPrintDialog KURLRequesterDlg 
KWizard KabAPI QColorDialog QfileDialog QFontDialog QInputDialog QMessageBox QPrintDialog 
QTabDialog QWizard 
구성자 

QDialog(QWidget *parent = 0， const char *name = 0， bool modal = FALSE, WFlags f = 0); 

메쏘드 

int exec(); 
void hide(); 

void move(int x, int y); 
void move(const QPoint &p); 
void resize(int w, int h); 
void resize(const QSize &); 
int result() const; 

void setGeometry(int x, int y, int w, int h); 
void setGeometry(const QRect &); 
void show(); 

렬거형 

enum DialogCode { Rejected, Accepted }; 

4 장에 QDialog 창문부품을 사용하여 대화칸창문을 구성하는 실례들이 있다. 

QFileDialog 

이 대화칸은 파일의 이름과 위치를 사용자로부터 얻을 때 사용된다. 

머리 부파일 






#include <qfiledialog.h> 

기초클라스 

QDialog QObject QPaintDevice QWidget Qt 

구성자 

QFileDialog(const QString &dirName, 

const QString &filter = QString: :null, QWidget *parent = 0, const char *name = 0, 
bool modal = FALSE); 

QFileDialog(QWidget *parent = 0, const char *name = 0, bool modal = FALSE); 

메쏘드 

const QDir *dir() const; 

QString dirPath() const; 

bool eventFilter(QObject *，QEvent *); 

static QString getExistingDirectory(const QString &dir = QString: :null, QWidget *parent = 0 ， 
const char *name = 0); 

static QString getExistingDirectory(const QString &dir, QWidget *parent, const char *name, 
const QString &caption); 

static QString getOpenFileName(const QString &initially = QString::null, 

const QString &filter = QString: :null, QWidget *parent = 0, const char *name = 0); 
static QString getOpenFileName(const QString &initially, const QString &filter, QWidget *parent, 
const char *name, const QString &caption); 
static QStringList getOpenFileNames(const QString &filter = QString::null, 

const QString &dir = QString::null, QWidget *parent = 0, const char *name = 0); 
static QStringList getOpenFileNames(const QString &filter, const QString &dir, QWidget *parent, 
const char *name, const QString &caption); 
static QString getSaveFileName(const QString &initially = QString::null, 

const QString &filter = QString: :null, QWidget *parent = 0, const char *name = 0); 
static QString getSaveFileName(const QString & initially, const QString &filter, QWidget *parent, 
const char *name, const QString &caption); 
static QFilelconProvider *iconProvider(); 
bool isContentsPreviewEnabled() const; 
bool isInfoPreviewEnabled() const; 

Mode mode() const; 

PreviewMode previewMode() const; 
void rereadDir(); 
void resortDir(); 
void selectAll(bool b); 
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QString selectedFile() const; 

QStringList selectedFiles() const; 

QString selectedFilter() const; 

void setContentsPreview(QWidget *w，QFilePreview *preview); 

void setContentsPreviewEnabled(bool); 

void setDir(const QDir &); 

static void setIconProvider(QFilelconProvider *); 

void setInfoPreview(QWidget *w, QFilePreview *preview); 

void setInfoPreviewEnabled(bool); 

void setMode(Mode); 

void setPreviewMode(PreviewMode m); 

void setSelection(const QString &); 

void setShowHiddenFiles(bool s); 

void setViewMode(ViewMode m); 

bool showHiddenFiles() const; 

QUrl url() const; 

ViewMode viewMode() const; 

처리부 

void setDir(const QString &); 
void setFilter(const QString &); 
void setFilters(const QString &); 
void setFilters(const char **); 
void setFilters(const QStringList &); 
void setUrl(const QUrlOperator &url); 

신호 

void dirEntered(const QString &); 
void fileHighlighted(const QString &); 
void fileSelected(const QString &); 

렬거형 

enum Mode { AnyFile, ExistingFile, Directory, ExistingFiles }; 

enum ViewMode { Detail, List }; 

enum PreviewMode { NoPreview, Contents, Info }; 

5 장에 QFileDialog 의 실례가 있다. 
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QFontDialog 


이 클라스는 서 체선택대화칸을 펼치는 정 적메쏘드들로 이루어져 있다. 

머리 부파일 

#include <qfontdialog.h> 

기초클라스 

QDialog QObject QPaintDevice QWidget Qt 

메쏘드 

static QFont getFont(bool *ok, const QFont &def, QWidget *parent = 0, const char *name = 0); 
static QFont getFont(bool *ok, QWidget *parent = 0, const char *name = 0); 

신호 

void fontHighlighted(const QFont &font); 
void fontSelected(const QFont &font); 

10 장에 QFontDialog 의 실례가 많다. 

QFrame 

이것은 틀로 둘러싸인 창문부품들의 기초클라스이다. 또한 빈 창문부품이므로 실례를 
만들어 다른 위체트들을 채울수 있다. 

머리 부파일 

#include <qframe.h> 

기 초클라스 

QObject QPaintDevice QWidget Qt 

파생 클라스 

KAboutContainer KAboutContributor KAccelMenu KAnimWidget KApplicationTree KCharSelect 
KCharSelectTable KColorCells KColorPatch KCombiView KDatelntemalMonthPicker 
KDatePicker KDateTable KDockWidgetAbstractHeader KDockWidgetAbstractHeaderDrag 
KDockWidgetHeader KDockWidgetHeaderDrag KDockWindow KEdit KFileDetailView 
KFilelconView KFilePreview KFormulaToolBar KHTMLView KIconCanvas KIconView 
KImageTrackLabel KlntSpinBox KListBox KListView KMenuBar KPopupMenu KPopupMenu 
KProgress KRuler KSeparator KSplitList KStatusBarLabel KTextBrowser KToolBar KURLLabel 
KURLRequester QButtonGroup QCanvasView 

QGrid QGroupBox QHBox QHButtonGroup QHGroupBox QlconView QLCDNumber QLabel 
QListBox QListView QMenuBar QMultiLineEdit QPopupFrame QPopupMenu QProgressBar 
QScrollView QSpinBox QSplitter QTableView QTextBrowser QTextView QVBox QVButtonGroup 
QVGroupBox QWellArray QWidgetStack 
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구성자 

QFrame(QWidget *parent = 0， const char *name = 0， WFlags f = 0, bool = TRUE); 

메쏘드 

QRect contentsRect() const; 

QRect frameRect() const; 

Shadow frameShadow() const; 

Shape frameShape() const; 

int frameStyle() const; 

int frameWidth() const; 

bool lineShapesOk() const; 

int lineWidth() const; 

int margin() const; 

int midLineWidth() const; 

virtual void setFrameRect(const QRect &); 

void setFrameShadow(Shadow); 

void setFrameShape(Shape); 

virtual void setFrameStyle(int); 

virtual void setLineWidth(int); 

virtual void setMargin(int); 

virtual void setMidLineWidth(int); 

QSize sizeHint() const; 

QSizePolicy sizePolicy() const; 

렬거형 

enum Shape { NoFrame=0, Box=0x0001, Panel=0x0002, WinPanel=0x0003, HLine=0x0004, 
VLine=0x0005,StyledPanel=0x0006, PopupPanel=0x0007, MShape=0x000f }; 
enum Shadow { Plain=0x0010, Raised=0x0020, Sunken=0x0030, MShadow=0x00f0 }; 

7 장에 QFrame 창문부품을 사용하는 많은 실례가 있다. 

QGrid 

이 배 치 관리 기 는 내 부적 으로 관리 되 는 살창우에 서 의 자리 표위 치 들에 따라 자식 창문부 
품들의 크기와 위치를 조절한다. 

머리 부파일 

#include <qgrid.h> 

기초클라스 

QFrame QObject QPaintDevice QWidget Qt 
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구성자 

QGrid(int n, QWidget *parent = 0， const char *name = 0， WFlags f = 0); 

QGrid(int n, Direction, QWidget *parent = 0， const char *name = 0, WFlags f = 0); 



enum Direction { Horizontal, Vertical }; 

3 장에 QGrid 의 실례가 많다. 

QGroupBox 

이 창문부품은 다른 창문부품들을 포함하고 경계선과 제목을 제공한다. 
머리 부파일 

#include <qgroupbox.h> 

기 초클라스 

QFrame QObject QPaintDevice QWidget Qt 

파생 클라스 


QButtonGroup QHButtonGroup QHGroupBox QVButtonGroup QVGroupBox 

구성 자 



void addSpace(int); 
int alignment() const; 
int columns() const; 

Orientation orientation() const; 
virtual void setAlignment(int); 

virtual void setColumnLayout(int columns, Orientation o); 

void setColumns(int); 

void setOrientation(Orientation); 


virtual void setTitle(const QString &); 
QString title() const; 





다음 실례는 QGroupBox 창문부품을 제 일웃준위창문으로 사용한다. 내용은 없지 만 그림 
18-3 에 보여준것처럼 제목문자렬이 주어진다. 

/* showgroupbox.cpp */ 

#include <qapplication.h> 

#include <qgroupbox.h> 
int main(int argc,char **argv) 

{ 

QApplication app(argc,argv); 

QGroupBox *groupbox = new QGroupBoxO ； 
groupbox->setTitle( M Group Title"); 
groupbox->showO ； 

app.setMainWidget(groupbox); 
retum(app. exec()); 

} 



그림 18-3. 제 일웃준위창문부품으로서 QGroupBox 

QHBox 

QHBox 창문부품은 창문부품들을 나란히 배치하는 간단한 용기이다. 

머리 부파일 

#include <qhbox.h> 

기초클라스 

QFrame QObject QPaintDevice QWidget Qt 

파생 클라스 

KCharSelect KURLRequester QVBox 

구성 자 

QHBox(QWidget *parent = 0， const char *name = 0， WFlags f = 0, bool allowLines = TRUE); 

메쏘드 

void setSpacing(int); 

bool setStretchFactor(QWidget *, int stretch); 

QSize sizeHint() const; 

다음 실례는 제 일웃준위 창문부품으로서 QHBox 를 사용한다. 자식창문부품으로서 4개의 




QLabel 창문부품을 가전다. 그림 18-4 에 보여주는것처럼 매개 표식자는 5화소너비로 나란히 
현시된다. 


/* showhbox.cpp */ 

#include <qapplication.h> 

#include <qhbox.h> 

#include <qlabel.h> 

int main(int argc，char **argv) 

{ 

QApplication app(argc,argv); 

QHBox *hbox = new QHBox(); 

new QLabel(”First”, hbox); 

new QLabel(” Second”, hbox); 

new QLabel( M Third M , hbox); 

new QLabel(”Fourth”, hbox); 

hbox->setSpacing(5); 

hbox->showO ； 

app. setMainWidget(hbox); 

retnm(app.exec()); 

} 



그림 18-4. QHBox 에 의 해 현시 된 표식 자들 

QHButtonGroup 

QHButtonGroup 는 수평 으로 단추들을 배 치 하는 용기창문부품이 다. 

머리 부파일 

#include <qhbuttongroup.h> 

기초클라스 

QButtonGroup QFrame QGroupBox QObject QPaintDevice QWidget 
Qt 

구성자 

QHButtonGroup(QWidget *parent = 0, const char *name = 0); 
QHButtonGroup(const QString &title, QWidget *parent = 0,const char *name = 0); 
7 장에 QHButtonGroup 를 사용한 실례프로그람이 있다. 



QHeader 


QHeader 창문부품은 많은 렬표제의 크기와 위치를 조종하는 용기이다. 
머리 부파일 

#include <qheader.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

구성자 

QHeader(QWidget *parent = 0， const char *name = 0); 

QHeader(int, QWidget *parent = 0， const char *name = 0); 

메쏘드 

int addLabel(const QString &, int size = - 1); 

int addLabel(const QlconSet &, const QString &, int size = - 1); 

int cellAt(int) const; 

int cellPos(int) const; 

int cellSize(int) const; 

int count() const; 

QlconSet *iconSet(int section) const; 

bool isClickEnabled(int section = - 1) const; 

bool isMovingEnabled() const; 

bool isResizeEnabled(int section = - 1) const; 

QString label(int section) const; 

int mapToActual(int) const; 

int mapToIndex(int section) const; 

int mapToLogical(int) const; 

int mapToSection(int index) const; 

virtual void moveCell(int, int); 

void moveSection(int section, int tolndex); 

int offset() const; 

Orientation orientation() const; 
void removeLabel(int section); 
void resizeSection(int section, int s); 
int sectionAt(int pos) const; 
int sectionPos(int section) const; 
int sectionSize(int section) const; 
virtual void setCellSize(int, int); 
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virtual void setClickEnabled(bool, int section = - 1); 

virtual void setLabel(int, const QString &， int size = - 1); 

virtual void setLabel(int, const QlconSet &, const QString &, int size = - 1); 

virtual void setMovingEnabled(bool); 

virtual void setOrientation(Orientation); 

virtual void setResizeEnabled(bool, int section = - 1); 

void setSortIndicator(int section, bool increasing = TRUE); 

virtual void setTracking(bool enable); 

QSize sizeHint() const; 

QSizePolicy sizePolicy() const; 
bool tracking() const; 

처리부 

virtual void setOffset(int pos); 

신호 

void clicked(int section); 

void indexChange(int section, int 分 omlndex, int tolndex); 

void moved(int, int); 

void pressed(int section); 

void released(int section); 

void sectionClicked(int); 

void sizeChange(int section, int oldSize, int newSize); 

다음 실례는 본문길이가 서로 다른 4개 렬의 QHeader 를 만든다. 매개 렬표제의 크기는 
마우스로 조절할수 있다. 표제는 본문이 명 백하지 않아도 거기 에 할당된 너 비를 유지한다. 
그림 18-5 에 보여주는것처럼 표제부는 창문의 오른쪽끝을 넘을수도 있고 하나의 렬표제가 
다른것 과 겹 치 도록 크기 를 변 경할수 있 다. 또한 렬 표제 는 본문을 현 시 하는데 필 요한 크기 이 
상으로 확장될수 있다. QHeader 창문부품에 의해 창조된 그룹은 표제의 아래에 있는 렬들의 
크기와 상태를 유지하는데 쓰일수 있다. 

/* showheader.cpp */ 

#include <qapplication.h> 

#include <qheader.h> 

int main(int argc’char **argv) 

{ 

QApplication app(argc,argv); 

QHeader *header = new QHeader(); 
header->addLabel("Column One”); 
header->addLabel("Two"); 
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header->addLabel("Three M ); 
header->addLabel( M Fourth Column"); 
header->showO ； 
app. setMainWidget(header); 
retum(app. exec()); 



그림 18-5. 4 렬의 표제를 포함하는 QHeader 창문부품 

QHGroupBox 

QHGroupBox 는 수평행안에 창문부품모임 을 배 치 하는 용기창문부품이 다. 

머리 부파일 

#include <qhgroupbox.h> 

기초클라스 

QFrame QGroupBox QObject QPaintDevice QWidget Qt 

구성자 

QHGroupBox(QWidget *parent = 0， const char *name = 0); 

QHGroupBox(const QString &title, QWidget *parent = 0， const char *name = 0); 

다음 실례는 QHGroupBox 창문부품안에 4개 표식자를 포함한다. 그림 18-6 에 보여주는것 
처럼 QHGroupBox 창문부품은 QFrame 로부터 계승되므로 포함된 창문부품들의 둘레에 경계선 
을 현시 하고 마음대로 제 목을 현시할수 있다. 

/* showhgroupbox.cpp */ 

#include <qapplication.h> 

#include <qhgroupbox.h> 

#include <qlabel.h> 

int main(int argc,char **argv) 

{ 

QApplication app(argc,argv); 

QHGroupBox *hgroupbox = new QHGroupBox(); 
new QLabel( M First", hgroupbox); 
new QLabel("Second", hgroupbox); 
new QLabel( M Third M , hgroupbox); 
new QLabel("Fourth M , hgroupbox); 



hgroupbox-〉setTitle (” Group Box Title”); 

hgroupbox->show(); 

app. setMainW idget(hgroupbox); 

retnm(app.exec()); 



그림 18-6. QHGroupBox 에 의 해 포함된 4개 단추 

QlconView 

QlconView 창문부품은 그림기호모임을 현시하며 사용자가 선택할수 있게 한다. 
머 러 부파일 

#include <qiconview.h> 

기초클라스 

QFrame QObject QPaintDevice QScrollView QWidget Qt 

파생 클라스 

KFilelconView KIconCanvas KlconView 

구성자 

QIconView(QWidget *parent = 0， const char *name = 0, WFlags f = 0); 

메쏘드 

Arrangement arrangement() const; 
bool autoArrangeO const; 
virtual void clear(); 
virtual void clearSelectionO； 
uint countO const; 

QlconViewItem *cnrrentltem() const; 

void ensureltemVisible(QIconViewltem *item); 

bool eventFilter(QObject *o, QEvent *); 

QlconViewItem *findFirstVisibleItem(const QRect &r) const; 

QlconViewItem *findItem(const QPoint &pos) const; 

QlconViewItem *findItem(const QString &text) const; 

QlconViewItem * fmdLastVisibleItem(const QRect &r) const; 

QlconViewItem *firstltem0 const; 
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int gridX() const; 
int gridY() const; 

int index(const QlconViewItem *item) const; 

virtual void insertItem(QIconViewItem *item, QlconViewItem * after = OL); 
virtual void invertSelection(); 

QBrush itemTextBackground() const; 

ItemTextPos itemTextPos() const; 
bool itemsMovable() const; 

QlconViewItem *lastltem() const; 
int maxItemTextLengthO const; 
int maxItemWidth() const; 

QSize minimumSizeHint() const; 

virtual void repaintItem(QIconViewItem *item); 

ResizeMode resizeMode() const; 
virtual void selectAll(bool select); 

SelectionMode selectionMode() const; 

virtual void setArrangement(Arrangement am); 

virtual void setAutoArrange(bool b); 

virtual void setCurrentItem(QIconViewItem *item); 

virtual void setFont(const QFont &); 

virtual void setGridX(int rx); 

virtual void setGridY(int ry); 

virtual void setltemTextBackground(const QBrush &b); 

virtual void setItemTextPos(ItemTextPos pos); 

virtual void setItemsMovable(bool b); 

virtual void setMaxItemTextLength(int w); 

virtual void setMaxItemWidth(int w); 

virtual void setPalette(const QPalette &); 

virtual void setResizeMode(ResizeMode am); 

virtual void setSelected(QIconViewItem *item, bool s，bool cb = FALSE); 

virtual void setSelectionMode(SelectionMode m); 

virtual void setShowToolTips(bool b); 

void setSorting(bool sort, bool ascending = TRUE); 

virtual void setSpacing(int sp); 

virtual void setWordWrapIconText(bool b); 

virtual void showEvent(QShowEvent *); 
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bool showToolTips() const; 

QSize sizeHint() const; 

QSizePolicy sizePolicy() const; 

virtual void sort(bool ascending = TRUE); 

bool sortDirection() const; 

bool sorting() const; 

int spacing() const; 

virtual void takeItem(QIconViewItem *item); 
bool wordWrapIconText() const; 

처리부 

virtual void arrangeItemsInGrid(const QSize &grid, bool update = TRUE); 
virtual void arrangeItemsInGrid(bool update = TRUE); 
virtual void setContentsPos(int x, int y); 
virtual void updateContents(); 

신호 

void clicked(QIconViewItem *); 
void clicked(QIconViewltem *, const QPoint &); 
void currentChanged(QIconViewItem *item); 
void doubleClicked(QIconViewItem *item); 

void dropped(QDropEvent *e, const QValueList < QIconDragltem > &lst); 
void itemRenamed(QIconViewItem *item, const QString &); 
void itemRenamed(QIconViewItem *item); 

void mouseButtonClicked(int button, QlconViewItem *item, const QPoint &pos); 
void mouseButtonPressed(int button, QlconViewItem *item, const QPoint &pos); 
void moved(); 

void onItem(QIconViewItem *item); 

void onViewport(); 

void pressed(QIconViewItem *); 

void pressed(QIconViewItem *, const QPoint &); 

void retumPressed(QIconViewItem *item); 

void rightButtonClicked(QIconViewItem *item, const QPoint &pos); 
void rightButtonPressed(QIconViewItem *item, const QPoint &pos); 
void selectionChanged(); 
void selectionChanged(QIconViewItem *item); 

렬거형 

enum SelectionMode { Single=0, Multi, Extended, NoSelection }; 
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enum Arrangement { LeftToRight=0, TopToBottom }; 
enum ResizeMode { Fixed=0, Adjust}; 
enum ItemTextPos { Bottom=0, Right}; 

다음 실례는 그림 18-7 에 보여준 5 개 그림기호를 현시한다. 첫째 그림기호는 픽스매프 
도 본문도 없으므로 기정픽스매프를 사용하고 표식자를 가지지 않는다. 다음 2개 그림기호 
는 기정픽스매프를 사용하지만 둘다 표식자본문을 가지고있다. 마지막 2개 그림기호는 픽스 
매프와 표식자를 모두 가지며 “Flag” 으로 표식된 그림기호가 마우스에 의해 선택되 였다. 

/* showiconview.cpp */ 

#include <qapplication.h> 

#include <qiconview.h> 
int main(int argc,char **argv) 

{ 

QlconViewItem *item; 

QApplication app(argc,argv); 

QlconView *iconview = new QlconViewO； 

item = new QIconViewItem(iconview); 

item = new QlconViewItem(iconview, "Icon Label"); 

item = new QIconViewItem(iconview, "Icon With\nLong Label”); 

QPixmap flag( M flag.png M ); 

item = new QIconViewItem(iconview, ” Flag”, flag); 

QPixmap idea (” idea.png”); 

item = new QIconViewItem(iconview, "Idea”, idea); 

iconview->show(); 

app. setMainW idget(iconview); 

retum(app. exec()); 

> 


QlconView 

■— 데척 ! 




□ 

Icon Label 

Icon With 

Long Label 

回 1 

■ 


Flag 

Idea 



그림 18-7. 5 개 그림 기호를 현시 하는 QlconView 창문부품 
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QlnputDialog 

QInputDialog 창문부품은 정적메쏘드들의 모임이며 매개 메쏘드는 사용자에게 입 력을 재 
촉하는 대화칸을 펼친다. 

머리 부파일 

#include <qinputdialog.h> 

기 초클라스 

QDialog QObject QPaintDevice QWidget Qt 

메쏘드 

static double getDouble(const QString &caption, const QString &label, double num = 0， 
double from = - 2147483647, double to = 2147483647, int step = 1, bool *ok = 0， 

QWidget *parent = 0， const char *name = 0); 
static int getInteger(const QString &caption, const QString &label, int num = 0, 

int from = - 2147483647, int to = 2147483647, int step = 1, bool *ok = 0, QWidget *parent 

= 0 , 

const char *name = 0); 

static QString getItem(const QString &caption, const QString &label, const QStringList &list, 
int current = 0, bool editable = TRUE, bool *ok = 0, QWidget *parent = 0, 
const char *name = 0); 

static QString getText(const QString &caption, const QString &label, 

const QString &text = QString: :null, bool *ok = 0, QWidget *parent = 0, const char *name = 

0)； 

다음 실례는 1.0-10.0 의 double 값을 사용자에게 요구한다. 사용자가 OK 단추를 선택하면 
Boolean 값 OK 는 true 로 설정되고 그렇지 않으면 false 로 설정된다. 그림 18-8 에 보여주는것처럼 
getDoubleO 에 넘기는 인수는 창문꼭대기에 제목을 설정하고 본문창문우에 재촉문을 현시한다. 

/* showcolordialog.cpp */ 

#include <qapplication.h> 

#include <qinputdialog.h> 

#include <iostream.h> 

int main(int argc,char **argv) 

{ 

bool OK; 

QApplication app(argc,argv); 

double value = QlnputDialog: : getDouble("A Double Value", "Enter a number from 1.0 to 10.0”， 

8.902, 1.0, 10.0, 1， &OK); 


if(OK) 
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cout « "The value is: ’’ « value « endl; 


else 

cout « "No data entered." « endl; 
retnm(app.exec()); 



그림 18-8. double 값을 요구하는 QInputDialog 대 화칸 

QLCDNumber 

QLCDNumber 창문부품은 LCD 현시 기의 수자들과 같은 서 체로 수를 현시한다. 
머리 부파일 

#include <qlcdnumber.h> 

기초클라스 

QFrame QObject QPaintDevice QWidget Qt 

구성 자 

QLCDNumber(QWidget *parent = 0， const char *name = 0); 

QLCDNumber(uint numDigits, QWidget *parent = 0, const char *name = 0); 

메쏘드 

bool checkOverflow(double num) const; 
bool checkOverflow(int num) const; 
int intValueO const; 

Mode modeO const; 
int numDigitsO const; 

SegmentStyle segmentStyle() const; 
virtual void setMode(Mode); 
virtual void setNumDigits(int nDigits); 
virtual void setSegmentStyle(SegmentStyle); 

QSize sizeHintO const; 

QSizePolicy sizePolicyO const; 
bool smallDecimalPoint() const; 
double valueQ const; 
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처 리 부 

void display(int num); 

void display(double num); 

void display(const QString &str); 

virtual void setBinMode(); 

virtual void setDecMode(); 

virtual void setHexMode(); 

virtual void setOctMode(); 

virtual void setSmallDecimalPoint(bool); 

신호 

void overflow(); 

렬거형 

enum Mode { Hex, HEX=Hex, Dec, DEC=Dec, Oct, OCT=Oct, Bin, BIN=Bin }; 
enum SegmentStyle { Outline, Filled, Flat }; 

3 장에 QLCDNumber 창문부품의 실례가 있다. 

QLabel 

QLabel 창문부품은 임의의 서 체로 형식 이 없는 본문을 현시한다. 

머리 부파일 

#include <qlabel.h> 

기 초클라스 

QFrame QObject QPaintDevice QWidget Qt 

파생 클라스 

KDockWindow KImageTrackLabel KStatusBarLabel KURLLabel 

구성 자 

QLabel(QWidget *parent, const char *name = 0, WFlags f = 0); 

QLabel(const QString &text, QWidget *parent, const char *name = 0, WFlags f = 0); 
QLabel(QWidget *buddy, const QString &, QWidget *parent, const char *name = 0, WFlags f = 0); 
메쏘드 

int alignment() const; 
bool autoResize() const; 

QWidget *buddy() const; 
int heightForWidth(int) const; 
int indent() const; 

QSize minimumSizeHint() const; 
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QMovie *movie() const; 

QPixmap *pixmap() const; 
virtual void setAlignment(int); 
void setAutoMask(bool); 
virtual void setAutoResize(bool); 
virtual void setBuddy(QWidget *); 
void setlndent(int); 
void setTextFormat(TextFormat); 

QSize sizeHint() const; 

QSizePolicy sizePolicy() const; 

QString text() const; 

TextFormat textFormat() const; 

처 리 부 

void clearO； 

virtual void setMovie(const QMovie &); 

virtual void setNum(int); 

virtual void setNum(double); 

virtual void setPixmap(const QPixmap &); 

virtual void setText(const QString &); 


QLineEdit 

QLineEdit 창문부품은 주로 자료입력에 쓰이는 간단한 한행본문편집기이다. 
머리 부파일 

#include <qlineedit.h> 

기 초클라스 

QObject QPaintDevice QWidget Qt 

파생 클라스 

KAccellnput KDatelntemalYearSelector KLineEdit KPasswordEdit KRestrictedLine 

구성 자 

QLineEdit(QWidget *parent, const char *name = 0); 

QLineEdit(const QString &, QWidget *parent, const char *name = 0); 

메쏘드 

int alignment() const; 
void backspace(); 
void copy() const; 
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void cursorLeft(bool mark, int steps = 1); 
int cursorPosition() const; 
void cursorRight(bool mark, int steps = 1); 
void cursorWordBackward(bool mark); 
void cursorWordForward(bool mark); 
void cut(); 
void del(); 

QString displayText() const; 

EchoMode echoMode() const; 
bool edited() const; 
void end(bool mark); 
bool frame() const; 
bool hasMarkedText() const; 
void home(bool mark); 
bool isReadOnly() const; 

QString markedText() const; 
int maxLength() const; 

QSize minimumSizeHint() const; 
void paste(); 

void setAlignment(int flag); 

virtual void setCursorPosition(int); 

virtual void setEchoMode(EchoMode); 

void setEdited(bool); 

virtual void setEnabled(bool); 

virtual void setFont(const QFont &); 

virtual void setFrame(bool); 

virtual void setMaxLength(int); 

virtual void setPalette(const QPalette &); 

void setReadOnly(bool); 

virtual void setSelection(int, int); 

virtual void setValidator(const QValidator *); 

QSize sizeHint() const; 

QSizePolicy sizePolicyO const; 

QString text() const; 

bool validateAndSet(const QString &, int, int, int); 
const QValidator *validator() const; 
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처 리 부 


void clearO； 

void clearValidator(); 

void deselect。; 

void insert(const QString &); 

void selectAll(); 

virtual void setText(const QString &); 

신호 

void retumPressed(); 

void textChanged(const QString &); 

렬거형 

enum EchoMode { Normal, NoEcho, Password }; 

4 장에 QLineEdit 창문부품을 사용하는 실례가 있다 

QListBox 

QListBox 창문부품은 마우스로 선 택 할수 있는 항목들의 목록을 현시한다. 
머리 부파일 

#include <qlistbox.h> 

기 초클라스 

QFrame QObject QPaintDevice QScrollView QWidget Qt 

파생 클라스 

KListBox KSplitList 

구성 자 

QListBox(QWidget *parent = 0， const char *name = 0， WFlags f = 0); 

메쏘드 

bool autoBottomScrollBar() const; 
bool autoScroll() const; 
bool autoScrollBar() const; 
bool autoUpdate() const; 
bool bottomScrollBar() const; 
int cellHeight(int i) const; 
int cellHeightO const; 
int cellWidth() const; 
int cellWidth(int i) const; 
void centerCurrentItem(); 
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void changeItem(const QListBoxItem *，int index); 

void changeItem(const QString &text, int index); 

void changeItem(const QPixmap &pixmap, int index); 

void changeItem(const QPixmap &pixmap, const QString &text, int index); 

void clear(); 

LayoutMode columnMode() const; 
uint count() const; 
int currentltem() const; 

QString currentText() const; 
bool dragSelect() const; 

QListBoxItem *findItem(const QString &text) const; 

QListBoxItem *firstltem() const; 

void inSort(const QListBoxItem *); 

void inSort(const QString &text); 

int index(const QListBoxItem *) const; 

void insertItem(const QListBoxItem *, int index = - 1); 

void insertItem(const QListBoxItem *, 

const QListBoxItem *after); 

void insertItem(const QString &text, int index = - 1); 

void insertItem(const QPixmap &pixmap, int index = - 1); 

void insertItem(const QPixmap &pixmap, const QString &text, int index = - 1); 

void insertStrList(const QStrList *, int index = - 1); 

void insertStrList(const QStrList &, int index = - 1); 

void insertStrList(const char **, int numStrings = - 1, int index = - 1); 

void insertStringList(const QStringList &, int index = - 1); 

bool isMultiSelection() const; 

bool isSelected(int) const; 

bool isSelected(const QListBoxItem *) const; 

QListBoxItem *item(int index) const; 

QListBoxItem *itemAt(QPoint) const; 
int itemHeight(int index = 0) const; 

QRect itemRect(QListBoxItem *item) const; 
bool itemVisible(int index); 
bool itemVisible(const QListBoxItem *); 
long maxItemWidth() const; 

QSize minimumSizeHint() const; 
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int numCols() const; 

int numColumns() const; 

int numItemsVisible() const; 

int numRows() const; 

const QPixmap *pixmap(int index) const; 

void removeItem(int index); 

LayoutMode rowMode() const; 
bool scrollBar() const; 

SelectionMode selectionMode() const; 

void setAutoBottomScrollBar(bool enable); 

void setAutoScroll(bool); 

void setAutoScrollBar(bool enable); 

void setAutoUpdate(bool); 

virtual void setBottomItem(int index); 

void setBottomScrollBar(bool enable); 

virtual void setColumnMode(LayoutMode); 

virtual void setColumnMode(int); 

virtual void setCurrentItem(int index); 

virtual void setCurrentItem(QListBoxItem *); 

void setDragSelect(bool); 

void setFixedVisibleLines(int lines); 

virtual void setFont(const QFont &); 

void setMultiSelection(bool multi); 

virtual void setRowMode(LayoutMode); 

virtual void setRowMode(int); 

void setScrollBar(bool enable); 

virtual void setSelected(QListBoxItem *，bool); 

void setSelected(int, bool); 

virtual void setSelectionMode(SelectionMode); 

void setSmoothScrolling(bool); 

virtual void setTopItem(int index); 

virtual void setVariableHeight(bool); 

virtual void setVariableWidth(bool); 

QSize sizeHint() const; 
bool smoothScrolling() const; 
void sort(bool ascending = TRUE); 
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void takeItem(const QListBoxItem *); 

QString text(int index) const; 

int topItem() const; 

void triggerUpdate(bool doLayout); 

bool variableHeight() const; 

bool variableWidth() const; 

void viewportPaintEvent(QPaintEvent *); 

처리부 

virtual void clearSelection(); 
virtual void ensureCurrentVisibleO ； 
void invertSelection(); 
void selectAll(bool select); 

신호 

void clicked(QListBoxItem *); 

void clicked(QListBoxItem *, const QPoint &); 

void currentChanged(QListBoxItem *); 

void doubleClicked(QListBoxItem *); 

void highlighted(int index); 

void highlighted(const QString &); 

void highlighted(QListBoxItem *); 

void mouseButtonClicked(int, QListBoxItem *, const QPoint &); 

void mouseButtonPressed(int, QListBoxItem *, const QPoint &); 

void onItem(QListBoxItem *item); 

void onViewport(); 

void pressed(QListBoxItem *); 

void pressed(QListBoxItem *, const QPoint &); 

void retumPressed(QListBoxItem *); 

void rightButtonClicked(QListBoxItem *, const QPoint &); 

void rightButtonPressed(QListBoxItem *, const QPoint &); 

void selected(int index); 

void selected(const QString &); 

void selected(QListBoxItem *); 

void selectionChanged(); 

void selectionChanged(QListBoxItem *); 

렬거형 

enum SelectionMode { Single, Multi, Extended, NoSelection }; 
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enum LayoutMode { FixedNumber, FitToWidth, FitToHeight=FitToWidth, Variable }; 

3 장과 8 장에 QListBox 창문부품의 실례가 있다. 

QListView 

QListView 창문부품은 나무구조의 항목목록을 현시하고 마우스를 리용하여 매 하옥들을 
열람할수 있게 한다. 

머리 부파일 

#include <qlistview.h> 

기 초클라스 

QFrame QObject QPaintDevice QScrollView QWidget Qt 

파생 클라스 

KApplicationTree KFileDetailView KListView 

구성 자 

QListView(QWidget *parent = 0， const char *name = 0); 

메쏘드 

virtual int addColumn(const QString &label, int size = - 1); 

virtual int addColumn(const QlconSet &iconset, const QString &label, int size = - 1); 

bool allColumnsShowFocus() const; 

int childCount() const; 

virtual void clear(); 

virtual void clearSelection(); 

int columnAlignment(int) const; 

QString columnText(int column) const; 
int columnWldth(int column) const; 

WidthMode columnWidthMode(int column) const; 
int columns() const; 

QListViewItem *currentltem() const; 

void ensureItemVisible(const QListViewItem *); 

bool eventFilter(QObject *o, QEvent *); 

QListViewItem *firstChild() const; 

QHeader *header() const; 

virtual void insertItem(QListViewItem *); 

bool isMultiSelection() const; 

bool isOpen(const QListViewItem *) const; 

bool isSelected(const QListViewItem *) const; 




QListViewItem *itemAt(const QPoint &screenPos) const; 

int itemMargin() const; 

int itemPos(const QListViewItem *); 

QRect itemRect(const QListViewItem *) const; 

QSize minimumSizeHint() const; 
void removeColumn(int index); 
virtual void removeItem(QListViewItem *); 
void repaintItem(const QListViewItem *) const; 
bool rootIsDecorated() const; 

QListViewItem *selectedltem() const; 

SelectionMode selectionMode() const; 

virtual void setAllColumnsShowFocus(bool); 

virtual void setColumnAlignment(int, int); 

virtual void setColumnText(int column, const QString &label); 

virtual void setColumnText(int column, const QlconSet &iconset, const QString &label); 

virtual void setColumnWidth(int column, int width); 

virtual void setColumnWidthMode(int column, WidthMode); 

virtual void setCurrentItem(QListViewItem *); 

virtual void setFont(const QFont &); 

virtual void setltemMargin(int); 

virtual void setMultiSelection(bool enable); 

virtual void setOpen(QListViewItem *, bool); 

virtual void setPalette(const QPalette &); 

virtual void setRootIsDecorated(bool); 

virtual void setSelected(QListViewItem *, bool); 

void setSelectionMode(SelectionMode mode); 

void setShowSortIndicator(bool show); 

virtual void setSorting(int column, bool increasing = TRUE); 
virtual void setTreeStepSize(int); 
void showO； 

bool showSortIndicator() const; 

QSize sizeHint() const; 
void sortO； 

virtual void takeItem(QListViewItem *); 
int treeStepSizeQ const; 


472 







처 리 부 

void invertSelection() ; 
void selectAll(bool select); 
void setContentsPos(int x，int y); 
void triggerUpdate(); 

신호 

void clicked(QListViewItem *); 

void clicked(QListViewItem *，const QPoint &, int); 

void collapsed(QListViewItem *item); 

void currentChanged(QListViewItem *); 

void doubleClicked(QListViewltem *); 

void expanded(QListViewItem *item); 

void mouseButtonClicked(int, QListViewItem *, const QPoint &, int); 

void mouseButtonPressed(int, QListViewItem *, const QPoint &, int); 

void onItem(QListViewItem *item); 

void onViewport(); 

void pressed(QListViewItem *); 

void pressed(QListViewItem *, const QPoint &, int); 

void retumPressed(QListViewltem *); 

void rightButtonClicked(QListViewItem *, const QPoint &, int); 
void rightButtonPressed(QListViewItem *, const QPoint &, int); 
void selectionChanged(); 
void selectionChanged(QListViewItem *); 

렬거형 

enum WidthMode { Manual, Maximum }; 

enum SelectionMode { Single, Multi, Extended, NoSelection }; 

QListView 창문부품에 현시된 나무들은 여러준위이고 보조나무들을 마우스로 펼치고 닫 
을수 있다. 나무들은 여러 층의 깊이를 가질수 있고 나무의 마디는 많은 창문부품들중의 하 
나일수 있다. 그러므로 각이한 렬들을 만들수 있고 많은 나무들이 있을수 있다. 흘림띠는 바 
닥에 나타나고 필요하다면 오른쪽에도 나타나며 여러 렬들이 사용되면 매개 나무는 렬제목 
들의 크기를 변경하여 크기를 조종할수 있다. 

다음 실례는 검 사칸에 의해서 표시 된 잎매듭들을 가지 는 하나의 나무를 만든다. 매개 
내 부나무마디(:자식 마디 들을 조종할 능력 이 있는 마디 ) 는 QListViewItem 객 체 이 다. QValueList 형 
타는 QListViewItem 객체들의 모임을 담고있는 목록을 만드는데 사용된다. QValueList 의 
appendO 는 매개 QListViewItem 객체를 삽입 하는데 사용된다. 내부순환고리는 5개의 
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QCheckListltem 객체를 창조하고 매개 객체를 표시하는 마디옆에는 QCheckBox 가 있다. 그림 
18-9 에서 결과나무를 보여준다. 부모마디들중 2개는 열리고 검사칸 3개가 선택된 상태로 되 
여 있다. 

/* showlistiew.cpp */ 

#include <qapplication.h> 

#include <qlistview.h> 

int main(int argc,char **argv) 

QApplication app(argc,argv); 

QListView *listview = new QListView(O); 
listview- 〉 show(); 

listview->addColumn("Column Heading"); 
listview->setRootIsDecorated(TRUE); 

QValueList<QListViewItem *> valuelist; 
for(int i=l; i<6; i++) { 

QListViewItem *viewitem = new QListViewItem(listview, QString( M Parent %l”).arg(i)); 

valuelist.append(viewitem); 

for(int j=l; j<6; j++) { 

new QCheckListItem(viewitem, QString (” Child %1 of Parent %2").arg(j).arg(i), 

QCheckListltem: : CheckBox); 

} 

> 

listview->show(); 

app. setMainWidget(listview); 

retum(app. exec()); 



Column Heading 


@ | 년땐丄 J j 

0 Parent 2 

□ Child 1 of Parent 2 

□ Child 2 of Parent 2 

□ Child 3 of Parent 2 

□ Child 4 of Parent 2 

□ Child 5 of Parent 2 
포 Parent 3 


그림 18-9. 5 개 부모마디 를 가지 는 QListView 








QMainWindow 


QMainWindow 는 보통 응용프로그람의 기본창문이 요구하는 기능을 제공하는 제일웃준 
위창문으로 사용된 다. 그것 은 차림 표띠，도구띠 그리 고 상태 띠 를 제 공한다. 

머리 부파일 

#include <qmainwindow.h> 

기 초클라스 

QObject QPaintDevice QWidget Qt 

구성 자 

QMainWindow(QWidget *parent = 0， const char *name = 0， WFlags f = WType TopLevel); 

메쏘드 

void addToolBar(QToolBar *, ToolBarDock = Top, bool newLine = FALSE); 

void addToolBar(QToolBar *, const QString &label, ToolBarDock = Top, bool newLine = FALSE); 

QWidget *centralWidget() const; 
bool eventFilter(QObject *，QEvent *); 

bool getLocation(QToolBar *tb, ToolBarDock &dock, int &index, bool &nl, int &extraOffset) const; 

bool isDockEnabled(ToolBarDock dock) const; 

bool isDockEnabled(QToolBar *tb, ToolBarDock dock) const; 

bool isDockMenuEnabled() const; 

void lineUpToolBars(bool keepNewLines = FALSE); 

QMenuBar *menuBar() const; 

QSize minimumSizeHint() const; 

void moveToolBar(QToolBar *, ToolBarDock = Top); 

void moveToolBar(QToolBar *, ToolBarDock, bool nl, int index, int extraOffset = - 1); 

bool opaqueMoving() const; 

void removeToolBar(QToolBar *); 

bool rightJustification() const; 

virtual void setCentralWidget(QWidget *); 

virtual void setDockEnabled(ToolBarDock dock, bool enable); 

void setDockEnabled(QToolBar *tb, ToolBarDock dock, bool enable); 

void show(); 

QSize sizeHint() const; 

QStatusBar *statusBar() const; 

QList<QToolBar> toolBars(ToolBarDock dock) const; 
bool toolBarsMovable() const; 

QToolTipGroup *toolTipGroup() const; 
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bool usesBigPixmaps() const; 
bool usesTextLabel() const; 

처 리 부 

void setDockMenuEnabled(bool); 
void setOpaqueMoving(bool); 
virtual void setRightJustification(bool); 
void setToolBarsMovable(bool); 
virtual void setUsesBigPixmaps(bool); 
void setUsesTextLabel(bool); 
void whatsThis(); 

신호 


void endMovingToolBar(QToolBar *); 
void pixmapSizeChanged(bool); 
void startMovingToolBar(QToolBar *); 
void toolBarPositionChanged(QToolBar *); 
void usesTextLabelChanged(bool); 

렬거형 

enum ToolBarDock { Unmanaged, TomOff, Top, Bottom, Right, Left, Minimized }; 

다음 실례는 응용프로그람의 제 일웃준위창문으로서 QMainWindow 창문부품을 설정하는 
방법을 보여 준다. QMainWindow 창문부품은 다른 구성요소들 (QMainWindow 의 메쏘드들을 통 
하여 접근할수 있는것)의 용기로 리용된다. 이 구성요소들은 QMenuBar , QStatusBar , 
QToolTipGroup 그리고 QToolBar 객체들의 목록이다. 또한 중심 에 QWidget 를 포함하는데 그것 
은 응용프로그람의 기 본현시창문으로 된다. 

/* showmainwindow.cpp */ 

#include <qapplication.h> 

#include <qmainwindow.h> 
int main(int argc’char **argv) 

{ 

QApplication app(argc,argv); 

QMainWindow *mainwindow = new QMainWindow(); 

mainwindow->show(); 

app. setMainWidget(mainwindow); 

retum(app. exec()); 




QMenuBar 


QMenuBar 는 튀 여 나오기 차림 표그룹사이 의 관계 를 관리 하는 수평 띠 이 다. 

머리 부파일 

#include <qmenubar.h> 

기초클라스 

QFrame QMenuData QObject QPaintDevice QWidget Qt 
파생 클라스 
KMenuBar 
구성자 

QMenuBar(QWidget *parent = 0， const char *name = 0); 

메쏘드 

bool customWhatsThis() const; 
bool eventFilter(QObject *，QEvent *); 
int heightForWidth(int) const; 
void hide(); 

bool isDefaultUp() const; 

QSize minimumSize() const; 

QSize minimumSizeHint() const; 

Separator separator 。 const; 

void setDefaultUp(bool); 

virtual void setSeparator(Separator when); 

void show(); 

QSize sizeHint() const; 
void updateltem(int id); 

신호 

void activated(int itemld); 
void highlighted(int itemld); 

렬거형 

enum Separator {Nevei=0, InWindowsStyle= 1 }; 

다음 실례는 2 개의 튀 여 나오기차림 표를 포함하는 QMenuBar 를 보여 준다. 매개 튀 여 나오 
기 차림 표는 하나의 차림 표항목을 포함한다. 그림 18-10 은 두번째 튀 여나오기 차림 표가 능동으 
로 된 차림표띠를 보여준다. 

/* showmenubar.cpp */ 

#include <qapplication.h> 

#include <qmenubar.h> 
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int main(int argc，char **argv) 

{ 

QApplication app(argc,argv); 

QMenuBar *menubar = new QMenuBar(); 

menubar->setSeparator(QMenuBar::InWindowsStyle); 

QPopupMenu* filePopup = new QPopupMenu(); 

filePopup->insertItem( M &Quit", &app, SLOT(quit())); 

menubar->insertItem( M &File” ， filePopup); 

QPopupMenu* editPopup = new QPopupMenu(); 

editPopup->insertItem( M &Paste M ); 

menubar->insertItem( M E&dit M ,editPopup); 

menubar->show(); 

app. setMainW idget(menubar); 

retum(app.exec()); 

} 



그림 18-10. 2 개 의 튀 여 나오기 차림 표를 가진 QMenuBar 

QMessageBox 

QMessageBox 는 사용자에게 정보를 현시하기 위하여 펼치고 응답을 기다리는 대화칸이 
다. 그것은 여 러가지 그림기호들과 선택단추들을 비롯한 많은 요소가 있다. 

머리 부파일 

#include <qmessagebox.h> 

기초클라스 

QDialog QObject QPaintDevice QWidget Qt 

구성자 

QMessageBox(QWidget *parent = 0, const char *name = 0); 

QMessageBox(const QString &caption, const QString &text, Icon icon, int buttonO, int button 1, int bu 

tton2, 

QWidget *parent = 0, const char *name = 0, bool modal = TRUE, WFlags f = WStyle DialogBorde 

r )； 

메쏘드 

static void about(QWidget *parent, const QString &caption, const QString &text); 
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static void aboutQt(QWidget *parent, const QString &caption = QString::null); 
void adjustSize(); 

QString buttonText(int button) const; 

static int critical(QWidget *parent, const QString &caption, const QString &text, int buttonO, 
int button 1, int button2 = 0); 

static int critical(QWidget *parent, const QString &caption, const QString &text, 

const QString &buttonOText = QString::null, const QString &buttonlText = QString::null, 
const QString &button2Text = QString: :null, int defaultButtonNumber = 0, 
int escapeButtonNumber = - 1); 

Icon icon() const; 

const QPixmap *iconPixmap() const; 

static int information(QWidget *parent, const QString &caption, const QString &text, int buttonO, 
int button 1 = 0 ， int button2 = 0); 

static int information(QWidget *parent, const QString &caption, const QString &text, 

const QString &buttonOText = QString::null, const QString &buttonlText = QString::null, 
const QString &button2Text = QString: :null, int defaultButtonNumber = 0, 
int escapeButtonNumber = - 1); 

static int message(const QString &caption, const QString &text, 

const QString &buttonText = QString::null, QWidget *parent = 0, const char *name = 0); 
static bool query(const QString &caption, const QString &text, 

const QString &yesButtonText = QString: :null, const QString &noButtonText = QString: :null, 
QWidget *parent = 0, const char *name = 0); 
void setButtonText(int button, const QString &); 
void setlcon(Icon); 
void setIcon(const QPixmap &); 
void setIconPixmap(const QPixmap &); 
void setText(const QString &); 
void setTextFormat(TextFormat); 

static QPixmap standardIcon(Icon icon, GUIStyle style); 

QString text() const; 

TextFormat textFormat() const; 

static int waming(QWidget *parent, const QString &caption, const QString &text, int buttonO, 
int button 1, int button2 = 0); 

static int waming(QWidget *parent, const QString &caption, const QString &text, 

const QString &buttonOText = QString::null, const QString &buttonlText = QString::null, 


const QString &button2Text = QString: :null, int defaultButtonNumber = 0, 
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int escapeButtonNumber = - 1); 

렬거형 

enum Icon { Nolcon=0, Information=l, Waming=2, Critical=3 }; 

enum (anon) { Ok=l, Cancel=2, Yes=3, No=4, Abort=5, Retry=6, Ignore=7, ButtonMask=0x07, 
Default=0xl00, Escape=0x200, FlagMask=0x300 }; 

다음 실례는 정적메쏘드들중 하나를 사용하여 미리 구성된 QMessageBox 를 펼친다. 그 
림 18-11 은 정보그림기호를 가지는 통보칸을 보여준다. 

/* showmessgebox.cpp */ 

#include <qapplication.h> 

#include <qmessagebox.h> 
int main(int argc,char **argv) 

{ 

QApplication app(argc,argv); 

QMessageBox::information(0, ” The Caption of an Informaton Box", 

"This is a QMessageBox that is configured\n" 

"to display information to the user and\n” 

” wait for a response."); 
retnm(app.exec()); 

} 



그림 18-11. 정보그림기호를 사용하는 QMessageBox 

QMultiLineEdit 

QMultiLineEdit 창문부품은 사용자가 본문을 입 력 하고 현 존본문을 수정 할수 있 는 문서 편 
집기 이 다. 

머리 부파일 

#include <qmultilineedit.h> 

기초클라스 

QFrame QObject QPaintDevice QTableView QWidget Qt 

파생 클라스 


480 






구성자 


QMultiLineEdit(QWidget *parent = 0， const char *name = 0); 

메쏘드 

int alignment() const; 

bool atBeginning() const; 

bool atEnd() const; 

bool autoUpdate() const; 

void cursorPosition(int *line, int *col) const; 

void cursorWordBackward(bool mark); 

void cursorWordForward(bool mark); 

static int defaultTab Stop(); 

EchoMode echoMode() const; 
bool edited() const; 

void getCursorPosition(int *line, int *col) const; 
int hMargin() const; 

virtual void insertAt(const QString &s, int line, int col, bool mark = FALSE); 

virtual void insertLine(const QString &s, int line = - 1); 

bool isOverwriteMode() const; 

bool isReadOnly() const; 

bool isUndoEnabled() const; 

int leng 仕 i() const; 

int maxLength() const; 

int maxLineLength() const; 

int maxLineWidth() const; 

int maxLines() const; 

QSize minimumSizeHint() const; 
int numLines() const; 
virtual void removeLine(int line); 
void setAlignment(int flags); 
virtual void setAutoUpdate(bool); 

virtual void setCursorPosition(int line, int col, bool mark = FALSE); 
static void setDefaultTabStop(int ex); 
virtual void setEchoMode(EchoMode); 
void setEdited(bool); 

virtual void setFixedVisibleLines(int lines); 
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virtual void setFont(const QFont &font); 
virtual void setHMargin(int); 
void setMaxLength(int); 
virtual void setMaxLineLength(int); 
virtual void setMaxLines(int); 

virtual void setSelection(int row from, int col from, int row to, int col_t); 

void setUndoDepth(int); 

void setUndoEnabled(bool); 

virtual void setValidator(const QValidator *); 

void setWordWrap(WordWrap mode); 

void setWrapColumnOrWidth(int); 

void setWrapPolicy(WrapPolicy policy); 

QSize sizeHint() const; 

QSizePolicy sizePolicy() const; 

QString text() const; 

QString textLine(int line) const; 

int undoDepth() const; 

const QValidator *validator() const; 

Wordwrap wordWrap() const; 
int wrapColumnOrWidth() const; 

WrapPolicy wrapPolicy() const; 

처리부 

void append(const QString &); 

void clearO ； 

void copy() const; 

void copyText() const; 

void cut(); 

void deselect。; 

void insert(const QString &); 

void paste(); 

void redo(); 

void selectAll(); 

virtual void setOverwriteMode(bool); 
virtual void setReadOnly(bool); 
virtual void setText(const QString &); 
void undo(); 
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신호 


void redoAvailable(bool); 
void retumPressed(); 
void textChanged(); 
void undoAvailable(bool); 

렬거형 

enum EchoMode { Normal, NoEcho, Password }; 

enum Wordwrap { NoWrap, WidgetWidth, FixedPixelWidth, FixedColumnWidth }; 
enum WrapPolicy { AtWhiteSpace, Anywhere }; 

8 장에 QMultiLineEdit 창문부품을 사용하는 실례들이 있다. 

QPopupMen 니 

QPopupMenu 창문부품은 튀 여 나오기 차림 표이 다. 그것 은 보통 차림 표띠 혹은 부모튀 여 나 
오기차림표의 성원으로 나타난다. 

머리 부파일 

#include <qpopupmenu.h> 

기 초클라스 

QFrame QMenuData QObject QPaintDevice QWidget Qt 

파생 클라스 

KAccelMenu KPopupMenu KPopupMenu 

구성 자 

QPopupMenu(QWidget *parent = 0, const char *name = 0); 

메쏘드 

bool customWhatsThis() const; 
int exec(); 

int exec(const QPoint &pos, int indexAtPoint = 0); 
void hide(); 

int idAt(int index) const; 

int idAt(const QPoint &pos) const; 

int insertTearOffHandle(int id = - 1, int index = - 1); 

bool isCheckable() const; 

void popup(const QPoint &pos, int indexAtPoint = 0); 
virtual void setActiveltem(int); 
virtual void setCheckable(bool); 
void setFont(const QFont &); 
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void show(); 

QSize sizeHint() const; 
void updateltem(int id); 

신호 

void aboutToShow(); 

void activated(int itemld); 

void activatedRedirect(int itemld); 

void highlighted(int itemld); 

void highlightedRedirect(int itemld); 

6 장에 QPopupMenu 의 실례들이 있다 

QPrintDialog 

QprintDialog 창문부품은 사용자가 응용프로그람에 의해 인쇄환경 을 구성 하고 인쇄 를 조 
종할수 있는 대 면부이다. 

머리 부파일 

#include <qprintdialog.h> 

기 초클라스 

QDialog QObject QPaintDevice QWidget Qt 

구성 자 

QPrintDialog(QPrinter *，QWidget *parent = 0， const char *name = 0); 

메쏘드 

void addButton(QPushButton *but); 
static bool getPrinterSetup(QPrinter *); 

QPrinter *printer() const; 

void setPrinter(QPrinter *, bool = FALSE); 

QPrintDialog 의 다음 실례는 그림 18-12 에 보여주는 대화칸창문을 펼치는데 QPrinter 객체 
를 사용한다. 

/* showprintdialog.cpp */ 

#include <qapplication.h> 

#include <qprintdialog.h> 

#include <qprinter.h> 

#include <iostream.h> 

int main(int argc’char **argv) 

{ 

QApplication app(argc,argv); 
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QPrinter *printer = new QPrinterO ； 

bool OK = QPrintDialog::getPrinterSetup(printer); 

if(OK) 

cout « "Printer configuration set.” « endl; 

cout « "Printer configuration not set.” « endl; 
retum(app. exec()); 



그림 18-12. QPrintDialog 창문 
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QProgressBar 

QProgressBar 는 수평 진 척 상황띠 이 다. 

머리 부파일 

#include <qprogressbar.h> 

기초클라스 

QFrame QObject QPaintDevice QWidget Qt 

구성자 

QProgressBar(QWidget *parent = 0， const char *name = 0， WFlags f = 0); 

QProgressBar(int totalSteps, QWidget *parent = 0， const char *name = 0， WFlags f = 0); 

메쏘드 

bool centerIndicator() const; 
bool indicatorFollowsStyle() const; 

QSize minimumSizeHint() const; 
int progress() const; 
void setCenterIndicator(bool on); 
void setIndicatorFollowsStyle(bool); 
void showO ； 

QSize sizeHint() const; 

QSizePolicy sizePolicy() const; 
int totalSteps() const; 

처리부 

void reset(); 

virtual void setProgress(int progress); 
virtual void setTotalSteps(int totalSteps); 

다음 실례는 그림 18-13 에 보여주는것처럼 총 200걸음에서 현재 122걸음에 왔다는 상황 
띠를 보여준다. 그것은 61%의 걸음과 등가하다. 

/* showprogressbar.cpp */ 

#include <qapplication.h> 

#include <qprogressbar.h> 
int main(int argc’char **argv) 

{ 

QApplication app(argc,argv); 

QProgressBar *progressbar = new QProgressBar(); 
progressbar->setTotalSteps(200); 
progressbar->setProgress( 122); 
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progressbar->showO ； 

app. setMainWidget(progressbar); 

retum(app. exec()); 



그림 18-13. 실행걸음을 보여주는 QProgressBar 

QProgressDialog 

QProgressBar 는 Cancel 단추를 가진 수평진척상황띠이다. 이것은 QDialog 로부터 계승되는 
튀 여나오기 창문이 아니 라 창문부품이 다. 

머리 부파일 

#include <qprogressdialog.h> 

기초클라스 

QObject QPaintDevice QSemiModal QWidget Qt 

구성 자 

QProgressDialog(QWidget *parent = 0， const char *name = 0， bool modal = FALSE, WFlags f = 0); 
QProgressDialog(const QString &labelText, const QString &cancelButtonText, int totalSteps, 

QWidget *parent = 0, const char *name = 0, bool modal = FALSE, WFlags f = 0); 

메쏘드 

bool autoCloseO const; 
bool autoResetO const; 

QString labelText() const; 

int minimumDurationO const; 

int progressO const; 

void setAutoClose(bool b); 

void setAutoReset(bool b); 

void setBar(QProgressBar *); 

void setCancelButton(QPushButton *); 

void setLabel(QLabel *); 

QSize sizeHintO const; 
int totalStepsO const; 
bool wasCancelledO const; 

처 리 부 
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void cancelO ； 
void reset(); 

void setCancelButtonText(const QString &); 
void setLabelText(const QString &); 
void setMinimumDuration(int ms); 
void setProgress(int progress); 
void setTotalSteps(int totalSteps); 

신호 

void cancelledO ； 

다음 실례는 그림 18-14 에 보여주는것처럼 총 200걸음을 가지는데 현재 122걸음의 진척 
상황띠를 보여준다 . Cancel 단추는 cancelledO 신호를 발생하고 창문을 닫는다. 

/* showprogressdialog.cpp */ 

#include <qapplication.h> 

#include <qprogressdialog.h> 
int main(int argc,char **argv) 

{ 

QApplication app(argc,argv); 

QProgressDialog *progressdialog = new QProgressDialogO ； 
progressdialog->setTotalSteps(200); 
progressdialog->setProgres s( 122); 
progressdialog->showO ； 
app.setMainWidget(progressdialog); 
retum(app. exec()); 



그림 18-14. 진행상황과 Cancel 단추를 보여주는 QProgressDialog 

QPushButton 

QPushButton 은 그 형태를 바꾸어 마우스에 응답하는 경사진 경계를 가지는 창문부품이 


다. 
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머리 부파일 


#include <qpushbutton.h> 

기 초클라스 

QButton QObject QPaintDevice QWidget Qt 

파생 클라스 

KColorButton KDialogBaseButton KDockButton Private KIconButton KKeyButton 

구성 자 

QPushButton(QWidget *parent, const char *name = 0); 

QPushButton(const QString &text, QWidget *parent, const char *name = 0); 

QPushButton(const QlconSet &icon, const QString &text, QWidget *parent, const char *name = 0); 

메쏘드 

bool autoDefault() const; 

QlconSet *iconSet() const; 
bool isDefault() const; 
bool isMenuButton() const; 
void move(int x, int y); 
void move(const QPoint &p); 

QPopupMenu *popup() const; 

void resize(int w, int h); 

void resize(const QSize &); 

virtual void setAutoDefault(bool autoDef); 

virtual void setDefault(bool def); 

virtual void setGeometry(int x, int y, int w, int h); 

virtual void setGeometry(const QRect &); 

void setIconSet(const QlconSet &); 

virtual void setIsMenuButton(bool); 

void setPopup(QPopupMenu *popup); 

virtual void setToggleButton(bool); 

QSize sizeHint() const; 

QSizePolicy sizePolicy() const; 

처 리 부 

virtual void setOn(bool); 
void toggle。; 
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QRadioButton 


QRadioButton 은 마우스에 의해 on 또는 off 로 절환될수 있는 단추이다. 다른 라디오단추 
들을 가지는 그룹에 포함될 때에는 오직 그것들중의 하나가 임의의 시각에 on 으로 될수 있 
다. 

머리 부파일 

#include <qradiobutton.h> 

기초클라스 

QButton QObject QPaintDevice QWidget Qt 

구성자 

QRadioButton(QWidget *parent, const char *name = 0); 

QRadioButton(const QString &text, QWidget *parent, const char *name = 0); 

메쏘드 

bool isChecked() const; 

virtual void setChecked(bool check); 

QSize sizeHint() const; 

QSizePolicy sizePolicyQ const; 

7 장에 QRadioButton 의 많은 실례가 있다. 

QScrollBar 

QScrollBar 창문부품은 수직 또는 수평흘림띠로서 구성될수 있다. 

머리 부파일 

#include <qscrollbar.h> 

기초클라스 

QObject QPaintDevice QRangeControl QWidget Qt 

구성자 

QScrollBar(QWidget *parent, const char *name = 0); 

QScrollBar(Orientation, QWidget *parent, const char *name = 0); 

QScrollBar(int minValue, int maxValue, int LineStep, int PageStep, int value, Orientation, 

QWidget *parent, const char *name = 0); 

메쏘드 

bool draggingSlider() const; 
int lineStep() const; 
int maxValue() const; 
int minValue() const; 
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Orientation orientation() const; 

int pageStep() const; 

void setLineStep(int); 

void setMaxValue(int); 

void setMinValue(int); 

virtual void setOrientation(Orientation); 

void setPageStep(int); 

virtual void setPalette(const QPalette &); 

virtual void setTracking(bool enable); 

void setValue(int); 

QSize sizeHint() const; 

QSizePolicy sizePolicy() const; 
bool tracking() const; 
int value() const; 

신호 

void nextLineO ； 

void nextPage(); 

void prevLine(); 

void prevPage(); 

void sliderMoved(int value); 

void sliderPressed(); 

void sliderReleased(); 

void valueChanged(int value); 

대부분의 창문부품들과 달리 QScrollBar 창문부품의 모든 구성자는 부모창문부품을 요구 
한다. 다음 실례는 2개의 QScrollBar 객체를 만든다. 하나는 수평으로，다른 하나는 수직으로 
향한다. 그림 18-15 에 보여 준것처 럼 부모창문부품과 2개 흘림 띠 의 기하학적배치 는 흘림띠 들 
이 바닥의 표준위치와 창문의 오른쪽에 나타나도록 고정된다. 

/* showscrollbar.cpp */ 

#include <qapplication.h> 

#include <qscrollbar.h> 
int main(int argc’char **argv) 

{ 

QApplication app(argc,argv); 

Q Widget * widget = new QWidget(); 

QScrollBar *vscrollbar = new QScrollBar(Qt: : Vertical,widget); 

vscrollbar->setGeometry(200,0,30,200); 
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QScrollBar *hscrollbar = new QScrollBar(Qt::Horizontal,widget); 

hscrollbar->setGeometry(0,200,200,30); 

widget->setFixedSize(230,230); 

widget- 〉 showO; 

app. setMainWidget( widget); 
retum(app.exec()); 



그림 18 15. 수평 및 수직 QScrollBar 

QScrollView 

QScrollView 창문부품은 하나의 자식 창문부품을 보유하는 용기 창문부품이 며 그 일부분을 
현시할수 있다. 그것은 필요할 때 포함된 창문부품의 어떤 부분을 볼수 있게 마음대로 선택 
하게 하는 흘림띠들을 제공한다. 

머리 부파일 

#include <qscrollview.h> 

기초클라스 

QFrame QObject QPaintDevice QWidget Qt 

파생 클라스 

KApplicationTree KFileDetailView KFilelconView KHTMLView KIconCanvas KlconView KListBox 
KListView KSplitList KTextBrowser 

QCanvasView QlconView QListBox QListView QTextBrowser QTextView 

구성자 

QScrollView(QWidget *parent = 0, const char *name = 0, WFlags f = 0); 
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메쏘- 


virtual void addChild(Q Widget * child, int x = 0, int y = 0); 
bool childIsVisible(QWidget *child); 
int childX(QWidget *child); 
int childY(QWidget *child); 

QWidget *clipper() const; 
int contentsHeight() const; 

void contentsToViewport(int x, int y, int &vx, int &vy); 

QPoint contentsToViewport(const QPoint &); 
int contentsWid 仕 i() const; 
int contentsX() const; 
int contentsY() const; 

QWidget *comerWidget() const; 
bool dragAutoScroll() const; 
void enableClipper(bool y); 

ScrollBarMode hScrollBarMode() const; 

QScrollBar *horizontalScrollBar() const; 

QSize minimumSizeHint() const; 

virtual void moveChild(QWidget *child, int x, int y); 

void removeChild(QWidget * child); 

void removeChild(QObject *child); 

void repaintContents(int x, int y, int w, int h, bool erase = TRUE); 
void repaintContents(const QRect &r, bool erase = TRUE); 
void resize(int w, int h); 
void resize(const QSize &); 

ResizePolicy resizePolicy() const; 

virtual void setComerWidget(QWidget *); 

void setDragAutoScroll(bool b); 

virtual void setHScrollBarMode(ScrollBarMode); 

virtual void setResizePolicy(ResizePolicy); 

virtual void setVScrollBarMode(ScrollBarMode); 

void show(); 

void showChild(Q Widget * child, bool yes = TRUE); 

QSize sizeHint() const; 


QSizePolicy sizePolicy() const; 

void updateContents(int x, int y, int w, int h); 




void updateContents(const QRect &r); 

ScrollBarMode vScrollBarMode() const; 

QScrollBar *verticalScrollBar() const; 

QWidget *viewport() const; 

QSize viewportSize(int, int) const; 

void viewportToContents(int vx, int vy, int & 汉 ， int &y); 

QPoint viewportToContents(const QPoint &); 
int visibleHeight() const; 
int visibleWidth() const; 

처리부 

void center(int x, int y); 

void center(int x, int y, float xmargin, float ymargin); 
void ensureVisible(int x, int y); 

void ensureVisible(int x, int y, int xmargin, int ymargin); 

virtual void resizeContents(int w, int h); 

void scrollBy(int dx, int dy); 

virtual void setContentsPos(int x, int y); 

void setEnabled(bool enable); 

void updateScrollBars(); 

신호 

void contentsMoving(int x, int y); 

렬거형 

enum ResizePolicy { Default, Manual, AutoOne }; 
enum ScrollBarMode {Auto, AlwaysOff, AlwaysOn }; 

다음 실례는 QScrollView 창문부품에 QLCDNumber 창문부품을 삽입한다. 그림 18-16 에서 
QLCDNumber 창문부품의 일부를 볼수 있게 조종하는데 사용할수 있는 흘림띠들을 가지고있 
는 창문부품의 한 부분을 보여준다. 

/* showscrollview.cpp */ 

#include <qapplication.h> 

#include <qscrollview.h> 

#include <qlcdnumber.h> 
int main(int argc,char **argv) 

{ 

Q Application app(argc,argv); 

QScrollView *scrollview = new QScrollView(); 

QLCDNumber *number = new QLCDNnmber(); 
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number->setNumDigits(8); 

number->display(982.89021); 

number->setMinimumSize(600,400); 

scrollview->addChild(number); 

scrollview->show(); 

app. setMainW idget(scrollview); 

retum(app. exec()); 



그림 18-16. 자식창문부품의 일부분을 현시 하는 QScrollView 창문부품 

QSemiModal 

QSemiModal 창문부품은 같은 응용프로그람의 임의의 다른 창문에서 마우스호출을 금지 
함으로써 QWidget 에 상반성을 추가한다. 

머리 부파일 

#include <qsemimodal.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

파생 클라스 

QProgressDialog 

구성자 

QSemiModal(QWidget *parent = 0, const char *name = 0, bool modal = FALSE, WFlags f = 0); 

메쏘드 

void move(int x, int y); 

void move(const QPoint &p); 

void resize(int w, int h); 

void resize(const QSize &); 

virtual void setGeometry(int x, int y, int w, int h); 
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virtual void setGeometry(const QRect &); 
void show(); 

QSemiModal 창문부품은 단지 하나의 보충적 인 특성 을 가지 는 QWidget 이 다. 즉 구성 자의 
3번째 인수가 TRUE 이면 이 응용프로그람의 다른 창문은 마우스나 건반에 응답하지 않는다. 
다음 실례는 QSemiModal 이 어떤 다른 창문부품으로 사용될수 있다는것을 보여주며 그림 
18-17 과 같이 다른 창문부품들을 포함할수 있다. 또한 이 실례의 Exit 단추와 같이 모달창문 
부품이 사용자에게 탈출수단을 제공하는것은 아주 중요하다. 

/* showsemimodal.cpp */ 

#include <qapplication.h> 

#include <qpushbutton.h> 

#include <qsemimodal.h> 
int main(int argc，char **argv) 

{ 

QApplication app(argc,argv); 

QSemiModal *semimodal = new QSemiModal(0, ” semimodal，’, TRUE); 

QPushButton *button = new QPushButton( M Exit M , semimodal); 

QObject: : connect(button, SIGNAL(clickedO),&app,SLOT(quitO ))； 

semimodal->show(); 

app. setMainW idget(semimodal); 

retnm(app.exec()); 



그림 18-17. QPushButton 을 가진 QSemiModal 창문부품 

QSizeGrip 

QSizeGrip 창문부품은 창문의 오른쪽아래 구석 에 설계된 크기조절손잡이 이다. 
머리 부파일 

#include <qsizegrip.h> 

기초클라스 

QObject QPaintDevice Q Widget Qt 

구성 자 

QSizeGrip(QWidget *parent, const char *name = 0); 

메쏘드 
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QSize sizeHintO const; 
QSizePolicy sizePolicyQ const; 


다음 실례는 QSizeHandle 를 창문부품에 추가하고 마우스로 그것을 끌어서 포함된 창문 
부품의 크기를 변경하는것을 보여준다. 그림 18-18 은 오른쪽아래구석에 QResizeGrip 창문부품 


의 표준위치를 보여준다. 

/* showsizegrip.cpp */ 

#include <qapplication.h> 

#include <qsizegrip.h> 
int main(int argc,char **argv) 

{ 

Q Application app(argc,argv); 

QWidget *widget = new QWidget(); 
widget->setMinimumSize(200,150); 

QSizeGrip *sizegrip = new QSizeGrip(widget); 

sizegrip->setGeometry(170,120,30,30); 

widget- 〉 show(); 

app. setMainWidget(widget); 

retnm(app.exec()); 




그림 18-18. 창문의 오른쪽아래구석에 있는 QSizeGrip 

QSlider 

QSlider 창문부품은 마우스로 2개 극값사이에서 값을 조절하는데 쓰이는 궤도와 이동가 
능한 활차 ( thumb ) 를 현 시한다. 
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머리 부파일 


#include <qslider.h> 

기 초클라스 

QObject QPaintDevice QRangeControl Q Widget Qt 

구성 자 

QSlider(QWidget *parent, const char *name = 0); 

QSlider(Orientation, QWidget *parent, const char *name = 0); 

QSlider(int minValue, int maxValue, int pageStep, int value, Orientation, QWidget *parent, 
const char *name = 0); 

메쏘드 

int lineStep() const; 
int maxValue() const; 
int minValue() const; 

QSize minimumSizeHint() const; 

Orientation orientation() const; 

int pageStep() const; 

void setLineStep(int); 

void setMaxValue(int); 

void setMinValue(int); 

virtual void setOrientation(Orientation); 

void setPageStep(int); 

virtual void setPalette(const QPalette &); 

virtual void setTicklnterval(int); 

virtual void setTickmarks(TickSetting); 

virtual void setTracking(bool enable); 

QSize sizeHint() const; 

QSizePolicy sizePolicy() const; 

QRect sliderRect() const; 
int ticklnterval() const; 

TickSetting tickmarks() const; 
bool tracking() const; 
int value() const; 

처 리 부 

void addStep(); 
virtual void setValue(int); 
void subtractStep(); 
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신호 


void sliderMoved(int value); 
void sliderPressed(); 
void sliderReleased(); 
void valueChanged(int value); 

렬거형 

enum TickSetting { NoMarks=0, Above=l, Lefl=Above, Below=2, Right=Below, Bo 仕 i=3 }; 

다음 실례는 그림 18-19 와 같이 수직 및 수평미끄럼띠 각각 한개씩，그리고 눈금표식자 
를 현 시한다. 

/* showslider.cpp */ 

#include <qapplication.h> 

#include <qslider.h> 

int main(int argc’char **argv) 

{ 

QApplication app(argc,argv); 

QWidget *widget = new QWidget(); 

QSlider *vslider = new QSlider(Qt:: Vertical, widget); 
vslider->setTickmarks(QSlider::Left); 
vslider->setGeometry(200,0,30,200); 

QSlider *hslider = new QSlider(Qt: : Horizontal, widget); 

hslider->setTickmarks(QSlider::Above); 

hslider->setGeometry(0,200,200,30); 

widget->setFixedSize(230,230); 

widget->show(); 

app. setMainWidget(widget); 

retum(app.exec()); 

} 
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그림 18-19. 수평 QSLider 와 수직 QSLider 


QSpinBox 

QSpinBox 창문부품은 현재값 또는 설정값을 가지는 본문창문을 현시한다. 그리고 어떤 
값이 나 설정값을 다음 값으로 사용자가 절환할수 있는 2개의 단추를 가진다. 

머리 부파일 

#include <qspinbox.h> 

기초클라스 

QFrame QObject QPaintDevice QRangeControl QWidget Qt 

파생 클라스 

KIntSpinBox 

구성자 

QSpinBox(QWidget *parent = 0, const char *name = 0); 

QSpinBox(int minValue, int maxValue, int step = 1, QWidget *parent = 0， const char *name = 0); 

메쏘드 

ButtonSymbols buttonSymbols() const; 

virtual Q String cleanText() const; 

int lineStep() const; 

int maxValue() const; 

int minValueO const; 

virtual QString prefix() const; 

void setButtonSymbols(ButtonSymbols); 

void setLineStep(int); 








void setMaxV alue(int); 
void setMinValue(int); 

virtual void setSpecialValueText(const QString &text); 
virtual void setValidator(const QValidator *v); 
virtual void setWrapping(bool on); 

QSize sizeHint() const; 

QSizePolicy sizePolicy() const; 

QString specialValueTextO const; 
virtual QString suffix() const; 

QString textO const; 
const QValidator *validator() const; 
int value() const; 
bool wrapping() const; 

처리부 

virtual void setEnabled(bool); 

virtual void setPrefix(const QString &text); 

virtual void setSuffix(const QString &text); 

virtual void setValue(int value); 

virtual void stepDown(); 

virtual void stepUp(); 

신호 

void valueChanged(int value); 

void valueChanged(const QString &valueText); 

렬거형 

enum ButtonSymbols { UpDownArrows, PlusMinus }; 

다음 실례는 그림 18-20 과 같이 스핀칸을 만든다. 수값은 10〜 W 0 범위에서 변화할수 있 
고 화살단추를 선택하면 수값이 10씩 증가 또는 감소된다. 앞붙이와 뒤붙이있는 현시값을 
사용자정의할수 있으며 또는 현시문자렬을 setSpecialValueText () 호출로 완전히 교체할수 있 
다. 

/* showspinbox.cpp */ 

#include <qapplication.h> 

#include <qspinbox.h> 
int main(int argc’char **argv) 

{ 

Q Application app(argc,argv); 

QSpinBox *spinbox = new QSpinBox( 10,100,5); 
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spinbox->showO ； 

app. setMainWidget(spinbox); 

retum(app. exec()); 


그림 18-20. 옹근수값을 선택하는데 사용된 QSpinBox 

QSplitter 

QSplitter 창문부품은 요구에 따라 흘림띠를 가진 2개의 창문을 포함하며 마우스로 각자 
의 상대크기를 조절할수 있다. 

머리 부파일 

#include <qsplitter.h> 

기초클라스 

QFrame QObject QPaintDevice Q Widget Qt 

파생 클라스 

KCombiView KFHePreview 

구성 자 

QSplitter(QWidget *parent = 0, const char *name = 0); 

QSplitter(Orientation, QWidget *parent = 0, const char *name = 0); 

메쏘드 

QSize minimumSizeHint() const; 
void moveToFirst(QWidget *); 
void moveT oLast(Q W idget *); 
bool opaqueResizeO const; 

Orientation orientationO const; 
void refresh(); 

virtual void setOpaqueResize(bool = TRUE); 
virtual void setOrientation(Orientation); 
virtual void setResizeMode(QWidget *w, ResizeMode); 
void setSizes(QValueList < int >); 

QSize sizeHint() const; 

QSizePolicy sizePolicy() const; 

QValueList<int> sizesQ const; 



렬거형 

enum ResizeMode { Stretch, KeepSize, FoliowSizeHint}; 

7 장과 8 장에 QSplitter 의 실례가 있다 

QStatusBar 

QStatosBar 창문부품은 동적으로 설정 혹은 삭제할수 있는 본문행을 현시한다. 또한 자체 
와 부모창문의 크기를 조절하는데 사용되는 QSizeGrip 창문부품을 포함한다. 

머리 부파일 

#include <qstatusbar.h> 

기초클라스 

QObject QPaintDevice Q Widget Qt 

파생 클라스 

KStatusBar 

구성자 

QStatusBar(QWidget *parent = 0, const char *name = 0); 

메쏘드 

void addWidget(QWidget *, int stretch = 0, bool = FALSE); 
bool isSizeGripEnabled() const; 
void removeWidget(QWidget *); 
void setSizeGripEnabled(bool); 

처 리 부 

void clear(); 

void message(const QString &); 
void message(const QString & ， int); 

다음 실례는 그림 18-21 과 같이 QStatusBar 창문부품을 가진 창문을 현시한다. 이 종류의 
창문부품은 보통 창문의 바닥에 포함된다. 

/* showstatusbar.cpp */ 

#include <qapplication.h> 

#include <qstatusbar.h> 
int main(int argc，char **argv) 

{ 

Q Application app(argc,argv); 

QStatusBar *statusbar = new QStatusBar(); 
statusbar->setSizeGripEnabled(TRUE); 
statusbar->message( M The QSatusBar widget"); 
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statusbar->show(); 

app. setMainW idget(statusbar); 

retum(app. exec()); 



그림 18-21. QSizeGrip 창문부품이 허 용되 는 QStetusBar 창문부품 

QTabBar 

QTabBar 창문부품은 마우스로 개 별적으로 선택할수 있는 타브행을 현시한다. 
머 러 부파일 

#include <qtabbar.h> 

기초클라스 

QObject QPaintDevice Q Widget Qt 

구성자 

QTabBar(QWidget *parent = 0， const char *name = 0); 

메쏘드 

virtual int addTab(QTab *); 
int currentTabO const; 

virtual int insertTab(QTab *，int index = - 1); 

bool isT abEnabled(int) const; 

int keyboardFocusTab() const; 

virtual void layoutTabsO ； 

virtual void removeTab(QTab *); 

virtual void setShape(Shape); 

virtual void setTabEnabled(int, bool); 

Shape shapeO const; 
void show(); 

QSize sizeHint() const; 

QSizePolicy sizePolicy() const; 

QTab *tab(int); 

처 리 부 

virtual void setCurrentTab(int); 
virtual void setCurrentTab(QTab *); 



신호 


void selected(int); 

렬거형 

enum Shape { RoundedAbove, RoundedBelow, TriangularAbove, TriangularBelow }; 

다음 실례는 그림 18-22 와 같이 4개 타브와 QTabBar 를 만든다. 띠의 오른쪽끝에 부모창 
문이 타브들을 모두 포함하지 못할 때 나타나는 스핀단추가 있다. addTab () 호출은 타브를 선 
택할 때마다 selectedO 신호를 발생하는데 사용되는 옹근수식별번호를 돌려준다. 

/* showtabbar.cpp */ 

#include <qapplication.h> 

#include <qtabbar.h> 

int main(int argc,char **argv) 

{ 

Q Application app(argc,argv); 

QTabBar *tabbar = new QTabBarO ； 
tabbar->addT ab(new QT ab (” F irst")); 
tabbar->addT ab(new QTab (” Second”)); 
tabbar->addT ab(new QT ab( M Third M )); 
tabbar->addT ab(new QTab("Fourth M )); 
tabbar->showO ； 

app. setMainWidget(tabbar); 
retum(app. exec()); 



그림 18-22. 4 개 의 타브와 하나의 수평 스핀 단추를 가진 QTabBar 

QTabDialog 

QTabDialog 창문부품은 포함된 창문부품들을 탄창에 보관하는 용기 이 다. 

머 러 부파일 

#include <qtabdialog.h> 

기초클라스 

QDialog QObject QPaintDevice QWidget Qt 

구성자 

QTabDialog(QWidget *parent = 0, const char *name = 0, bool modal = FALSE, WFlags f = 0); 
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메쏘드 


void addTab(QWidget *，const QString &); 

void addTab(Q Widget * child, const QlconSet &iconset, 

const QString &label); 

void addTab(QWidget *, QTab *); 

void changeTab(QWidget *, const QString &); 

void changeTab(QWidget * child, const QlconSet &iconset, const QString &label); 

QWidget *currentPage() const; 
bool hasApplyButton() const; 
bool hasCancelButtonO const; 
bool hasDefaultButton() const; 
bool hasHelpButton() const; 
bool hasOkButton() const; 

void insertTab(QWidget *, const QString &, int index = - 1); 

void insertT ab(Q W idget * child, const QlconSet &iconset, const QString &label, int index = - 1); 

void insertTab(QWidget *, QTab *, int index = -1); 

bool isTabEnabled(QWidget *) const; 

bool isTabEnabled(const char *) const; 

void removePage(QWidget *); 

void setApplyButton(const QString &text); 

void setApplyButton(); 

void setCancelButton(const QString &text); 

void setCancelButton(); 

void setDefaultButton(const QString &text); 

void setDefaultButton(); 

void setFont(const QFont &font); 

void setHelpButton(const QString &text); 

void setHelpButton(); 

void setOKButton(const QString &text = QString:: null); 

void setOkButton(const QString &text); 

void setOkButton(); 

void setTabEnabled(QWidget * ， bool); 

void setT abEnabled(const char * ， bool); 

void show(); 

void showPage(QWidget *); 

QString tabLabel(QWidget *); 
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신호 


void aboutToShow(); 
void applyButtonPressed(); 
void cancelButtonPressed(); 
void defaultButtonPressed(); 
void helpButtonPressed(); 
void selected(const QString &); 

QTabDialog 창문부품의 실례는 5 장에 있다. 

QTabWidget 

QTabWidget 는 마우스로 개별적으로 선택할수 있는 타브들의 렬을 현시한다. 
머리 부파일 

#include <qtabwidget.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

구성자 

QTabWidget(QWidget *parent, const char *name, WFlags f); 

QTabWidget(QWidget *parent = 0, const char *name = 0); 

메쏘드 

void addTab(QWidget *，const QString &); 

void addTab(QWidget * child, const QlconSet &iconset, const QString &label); 

void addTab(QWidget *，QTab *); 

void changeTab(QWidget *, const QString &); 

void changeTab(QWidget *child, const QlconSet &iconset, const QString &label); 

QWidget *currentPage() const; 

void insertTab(QWidget *, const QString &, int index = - 1); 

void insertT ab(Q W idget * child, const QlconSet &iconset, const QString &label, int index = -1); 
void insertTab(QWidget *, QTab *, int index = -1); 
bool isTabEnabled(QWidget *) const; 
int margin() const; 

QSize minimumSizeHint() const; 
void removePage(QWidget *); 
void setMargin(int); 
void setTabEnabled(QWidget *, bool); 
void setTabPosition(TabPosition); 
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void showPage(QWidget *); 

QSize sizeHint() const; 

QString tabLabel(QWidget *); 

TabPosition tabPosi 仕 on() const; 

신호 

void selected(const QString &); 

렬거형 

enum TabPosition { Top, Bottom }; 

다음 실례는 그림 18-23 과 같이 4개 창문부품을 가지는 QTabWidget 용기를 만든다. 띠의 
오른쪽끝에 부모창문이 타브들을 모두 포함하지 못할 때 나타나는 스핀단추가 있다. 

/* showtabwidget.cpp */ 

#include <qapplication.h> 

#include <qtabwidget.h> 

#include <qlabel.h> 

int main(int argc’char **argv) 

{ 

QLabel *label; 

Q Application app(argc,argv); 

QTab Widget *tabwidget = new QTabWidget(); 

label = new QLabel("The First Widget Label", tabwidget); 

tabwidget->addTab(label, "First”); 

label = new QLabel("The Second Widget Label", tabwidget); 
tabwidget- 〉 addTab(label, ” Second”); 
label = new QLabel("The Third Widget Label", tab widget); 
tabwidget->addTab(label, ” Third”); 

label = new QLabel("The Fourth Widget Label", tabwidget); 

tabwidget- 〉 addTab(label, "Fourth"); 

tabwidget->show(); 

app. setMainW idget(tab widget); 

retum(app.exec()); 

} 
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그림 18-23. 4개 타브와 하나의 수평 스핀 단추를 가지 는 QtabWidget 


QTextBrowser 

QTextBrowser 창문부품은 창문에 본문을 현시하고 일련의 위치결정메쏘드들을 제공한다. 
기본본문은 QTextView 로부터 계승된다. 선택된 부분들을 얻을수 있다. 

머리 부파일 

#include <qtextbrowser.h> 

기초클라스 


QFrame QObject QPaintDevice QScrollView QTextView QWidget Qt 

파생 클라스 

KTextBrowser 

구성자 

QTextBrowser(QWidget *parent = 0， const char *name = 0); 

메쏘드 


void scrollToAnchor(const QString &name); 
virtual void setSource(const QString &name); 
void setText(const QString &contents, 
const QString &context = QString: inull); 

QString sonrce() const; 

처러부 

virtual void backward(); 
virtual void forward(); 
virtual void homeO ； 

신호 

void backwardAvailable(bool); 
void forwardAvailable(bool); 
void highlighted(const QString &); 
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void textChangedO ； 

다음 실례는 그림 18-24 와 같이 본문행 들을 현시한다. 

/* showtextbrowser.cpp */ 

#include <qapplication.h> 

#include <qtextbrowser.h> 
char text[] = 

” This is the text being displayed\n" 

"by the text browser. Both vertical\n M 
” and horizontal scroll bars will\n" 

"appear as necessary."; 
int main(int argc,char **argv) 

{ 

Q Application app(argc,argv); 

QTextBrowser *tex 仕 ) rowser = new QT extBro wserO ； 
textbrowser- 〉 show() ； 
textbrowser->setText(QString(text)); 
app. setMainW idget(textbrowser); 
retnm(app.exec()); 



This is the text being displayed 
by the text browser. Both vertical 
and horizontal scroll bars will 
appear as necessary. 


그림 18-24. 본문을 현시하는 QTextView 

QTextView 

QTextView 창문부품은 창문에 본문을 현시한다. 

머 러 부파일 

#include <qtextview.h> 

기초클라스 

QFrame QObject QPaintDevice QScrollView QWidget Qt 
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파생 클라스 

KTextBrowser QTextBrowser 

구성 자 

QTextView(QWidget *parent = 0， const char *name = 0); 

QTextView(const QString &text, const QString &context = QString::null, QWidget *parent = 0, 
const char *name = 0); 

메쏘드 

void append(const QString &text); 
virtual QString context() const; 

QString documentTitle() const; 
bool hasSelectedText() const; 
int heightForWidth(int w) const; 
const QColor & linkColor() const; 
bool linkUnderline() const; 

QMimeSourceFactory *mimeSourceFactory() const; 
const QBrush & paper(); 
const QBrush & paper() const; 
const QColorGroup & paperColorGroup() const; 

QString selectedText() const; 
void setLinkColor(const QColor &); 
void setLinkUnderline(bool); 

void setMimeSourceFactory(QMimeSourceFactory *factory); 

void setPaper(const QBrush &pap); 

void setPaperColorGroup(const QColorGroup &colgrp); 

void setStyleSheet(QStyleSheet *styleSheet); 

virtual void setText(const QString &text, const QString &context); 

void setText(const QString &text); 

void setT extF ormat(T extF ormat); 

QStyleSheet *styleSheet() const; 
virtual QString text() const; 

TextFormat textFormat() const; 

처리부 

void copy(); 
void selectAll(); 

다음 실례는 그림 18-25 과 같이 본문블로크를 현시한다. 

/* showtextview.cpp */ 
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#include <qapplication.h> 
#include <qtextview.h> 
char text[] = 


” This is the text being displayed\n M 
"by the text view. Both verticals” 

"and horizontal scroll bars will\n M 
"appear as necessary."; 
int main(int argc，char **argv) 

{ 

Q Application app(argc,argv); 

QTextView *textview = new QTextView(text); 

textview->show(); 

app. setMainW idget(textview); 

retum(app.exec()); 



그림 18-25. 본문을 현시하는 QTextView 창문부품 

QToolBar 

QToolBar 창문부품은 도구를 포함하는 도구띠이다. 도구띠조종은 창문부품일수 있으나 
대체로 본문대신에 그림기호를 가지는 작은 단추이다. 

머리 부파일 

#include <qtoolbar.h> 

기초클라스 

QObject QPaintDevice Q Widget Qt 

구성 자 

QToolBar(const QString &label, QMainWindow *, 

QMainW indow :: ToolBarDock = QMainWindow: :Top, 
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bool newLine = FALSE, const char *name = 0); 


QToolBar(const QString &label, QMainWindow *, QWidget *, bool newLine = FALSE, 
const char *name = 0, WFlags f = 0); 

QToolBar(QMainWindow *parent = 0, const char *name = 0); 

메쏘드 

void addSeparator(); 

void clear(); 

bool event(QEvent *e); 

bool eventFilter(QObject *, QEvent *); 

void hide(); 

bool isHorizontalStretchable() const; 
bool isVerticalStretchable() const; 

QString label() const; 

QMain Window *mainWindow(); 

QSize minimumSize() const; 

QSize minimumSizeHint() const; 

Orientation orientation() const; 
void setHorizontalStretchable(bool b); 
virtual void setLabel(const QString &); 
virtual void setOrientation(Orientation); 
virtual void setStretchableWidget(QWidget *); 
void setVerticalStretchable(bool b); 
void show(); 

신호 

void orientationChanged(Orientation); 

다음 실례는 QToolBar 를 창조하여 QMainWindow 창문부품에 련결한다. 그림 18-26 은 꼭 
대기 에 도구띠 를 보여 주지만 QMainWindow 창문부품은 네 변의 어디 에나 도구띠를 이동할수 
있게 한다. 도구띠에는 하나의 표준 QPushButton 창문부품과 3개의 QToolButton 창문부품이 포 
함된다. QToolButton 창문부품들중 하나는 화살표를 현시하고 다른 두개는 픽스매프들을 현시 
한다. 이것은 실례를 간단하게 하지만 단추들에는 보통 단추가 능동으로 될 때 호출되는 처 
리부메쏘드들이 할당된다. 

/* showtoolbar.cpp */ 

#include <qapplication.h> 

#include <qmainwindow.h> 

#include <qtoolbar.h> 

#include <qtoolbutton.h> 
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#include <qpushbutton.h> 
int main(int argc，char **argv) 

{ 

QApplication app(argc,argv); 

QMainWindow *mainwindow = new QMainWindowO ； 
QToolBar *toolbar = new QToolBar (” Bar”, mainwindow); 
new QPushButton (” Button”, toolbar); 

QPixmap idea(”idea.png”); 

new QToolButton(idea, "Idea","Group",0,0,toolbar); 
QPixmap flag (” flag.png”); 

new QToolButton(flag, "Flag","Group",0,0,toolbar); 

new QToolButton(Qt: lUpArrow, toolbar); 

mainwindow->showO ； 

app. setMainWidget(mainwindow); 

retum(app. exec()); 

> 



그림 18-26. 4 개 단추를 가지 는 QToolBar 

QToolButton 

QToolButtcm 창문부품은 도구띠의 성원으로 포함되도록 설계된 특수한 단추창문부품이다. 
그것 은 본문, 적 스매 프 또는 본문과 픽 스매 프를 동시 에 현 시할수 있 다. 

머리 부파일 

#include <qtoolbutton.h> 

기초클라스 

QButton QObject QPaintDevice QWidget Qt 

구성자 

QToolButton(QWidget *parent, const char *name = 0); 





QToolButton(const QPixmap &pm, const QString &textLabel, const QString &grouptext, 
QObject *receiver, const char *slot, QToolBar *parent, const char *name = 0); 
QToolButton(const QlconSet &s, const QString &textLabel, const QString &grouptext, 
QObject *receiver, const char *slot, QToolBar *parent, const char *name = 0); 

QToolButton(ArrowType type, QWidget *parent, const char *name = 0); 

메쏘드 

bool autoRaise() const; 

QlconSet iconSet(bool on = FALSE) const; 

QlconSet offIconSet() const; 

QlconSet onIconSet() const; 

QPopupMenu *popup() const; 
int popupDelay() const; 
void setAutoRaise(bool enable); 

virtual void setIconSet(const QlconSet &, bool on = FALSE); 
void setOffIconSet(const QlconSet &); 
void setOnIconSet(const QlconSet &); 
void setPopup(QPopupMenu *popup); 
void setPopupDelay(int delay); 

QSize sizeHint() const; 

QSizePolicy sizePolicy() const; 

QString textLabel() const; 
bool usesBigPixmap() const; 
bool usesTextLabel() const; 

처리부 

virtual void setOn(bool enable); 

virtual void setTextLabel(const QString &, bool); 

void setTextLabel(const QString &); 

virtual void setToggleButton(bool enable); 

virtual void setUsesBigPixmap(bool enable); 

virtual void setUsesTextLabel(bool enable); 

void toggle(); 

QToolButton 의 실례는 이 장의 QToolBar 에 있다. 

QVBox 


QVBox 는 자식창문부품들을 겹 쌓여 배 치 하는 간단한 용기 이 다. 



머리 부파일 


#include <qvbox.h> 

기초클라스 

QFrame QHBox QObject QPaintDevice QWidget Qt 

파생 클라스 

KCharSelect 

구성 자 

QVBox(QWidget *parent = 0， const char *name = 0， WFlags f = 0, bool allowLines = TRUE); 

다음 실례는 제 일웃준위 창문부품으로서 QVBox 를 사용한다. 그것은 자식창문부품으로서 
4개의 QLabel 창문부품을 가지고있다. 그림 18-27 과 같이 매개 표식자는 5화소너비의 공간을 
두고 현시된다. 

/* showvbox.cpp */ 

#include <qapplication.h> 

#include <qvbox.h> 

#include <qlabel.h> 

int main(int argc，char **argv) 

{ 

Q Application app(argc,argv); 

QVBox *vbox = new QVBoxO ； 
new QLabel( M First M , vbox); 
new QLabel(”Second”, vbox); 
new QLabelC'Third", vbox); 
new QLabel( M Fourth M , vbox); 
vbox->setSpacing(5); 
vbox->show0 ； 
app. setMainWidget(vbox); 
retum(app. exec()); 

} 

First 

Second 

Third 

Fourth 

그림 18-27. QVBox 에 의 해 현시 된 표식 자들 
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QVButtonGroup 


QVButtonGroup 는 수직 렬 에 단추모 임 을 배 치 하는 용기창문부품이 다. 

머리 부파일 

#include <qvbuttongroup.h> 

기초클라스 

QButtonGroup QFrame QGroupBox QObject QPaintDevice QWidget Qt 

구성자 

QVButtonGroup(QWidget *parent = 0， const char *name = 0); 

QVButtonGroup(const QString &title, QWidget *parent = 0, const char *name = 0); 

7 장에 QVButtonGroup 의 실례가 있다 

QVGroupBox 

QVGroupBox 는 수직 렬 에 창문부품모임 을 배 치 하는 용기창문부품이 다. 

머리 부파일 

#include <qvgroupbox.h> 

기 초클라스 

QFrame QGroupBox QObject QPaintDevice QWidget Qt 

구성 자 

QVGroupBox(QWidget *parent = 0, const char *name = 0); 

QVGroupBox(const QString &title, QWidget *parent = 0, const char *name = 0); 

다음 실례는 QVGroupBox 창문부품안에 4개 표식자를 포함한다. 그림 18-28 과 같이 
QVGroupBox 창문부품은 QFrame 을 계승하므로 포함된 창문부품들의 둘레에 경계선을 현시하 
고 마음대 로 제 목을 현시할수 있다. 

/* showvgroupbox. cpp */ 

#include <qapplication.h> 

#include <qvgroupbox.h> 

#include <qlabel.h> 

int main(int argc’char **argv) 

{ 

Q Application app(argc,argv); 

QVGroupBox *vgroupbox = new QVGroupBox(); 
new QLabel( M First M , vgroupbox); 
new QLabel(”Second”, vgroupbox); 
new QLabel("Third M , vgroupbox); 



new QLabel("Fourth", vgroupbox); 
vgroupbox- 〉 setTitle (” Group Box Title"); 
vgroupbox->show(); 
app. setMainWidget(ygroupbox); 
retum(app. exec()); 



First 

Second 

Third 

Fourth 

그림 18-28. QVGroupBox 에 의 해 포함된 4개 단추 

QWidget 

QWidget 클라스는 모든 사용자대면부클라스의 기초클라스이다. 

머리 부파일 

#include <qwidget.h> 

기초클라스 

QObject QPaintDevice Qt 

파생 클라스 

QWidget 를 기초클라스로 사용하는 Qt 와 KDE 의 매개 창문부품. 

구성 자 

QWidget(QWidget *parent = 0, const char *name = 0, WFlags f = 0); 

메쏘드 

bool acceptDropsO const; 

virtual void adjustSize(); 

bool autoMask() const; 

const QColor & backgroundColorO const; 

BackgroundMode backgroundModeO const; 

BackgroundOrigin backgroundOriginO const; 
const QPixmap *backgroundPixmap() const; 

QSize baseSize() const; 

QString captionO const; 

QRect childrenRectO const; 


518 





QRegion childrenRegion() const; 

void clearMask(); 

virtual bool close(bool alsoDelete); 

const QColorGroup & colorGroup() const; 

const QCursor & cursor() const; 

virtual bool customWhatsThis() const; 

void drawText(int x，int y, const QString &); 

void drawText(const QPoint &， const QString &); 

void erase(); 

void erase(int x, int y, int w, int h); 
void erase(const QRect &); 
void erase(const QRegion &); 
static QWidget *find(WId); 

FocusPolicy focusPolicy() const; 

QWidget *focusProxy() const; 

QWidget *focusWidget() const; 

QFont font() const; 

QFontlnfo fontlnfoO const; 

QFontMetrics fontMetrics() const; 
PropagationMode fontPropagation() const; 
const QColor & foregroundColor() const; 

QRect frameGeometryO const; 

QSize frameSize() const; 

const QRect & geometry() const; 

void grabKeyboard(); 

void grabMouse(); 

void grabMouse(const QCursor &); 

bool hasFocus() const; 

bool hasMouseTracking() const; 

int height() const; 

virtual int heightForWidth(int) const; 
const QPixmap *icon() const; 

QString iconText() const; 
bool isActiveWindow() const; 
bool isDesktop() const; 
bool isEnabled() const; 





bool isEnabledTo(QWidget *) const; 
bool isEnabledToTLW() const; 
bool isF ocusEnabled() const; 
bool isMinimized() const; 
bool isModal() const; 
bool isPopup() const; 
bool isTopLevel() const; 
bool isUpdatesEnabled() const; 
bool isVisible() const; 
bool isVisibleTo(QWidget *) const; 
bool isVisibleToTLW() const; 
static QWidget *keyboardGrabber(); 

QLayout *layout() const; 

QPoint mapF romGlobal(const QPoint &) const; 

QPoint mapFromParent(const QPoint &) const; 

QPoint mapT oGlobal(const QPoint &) const; 

QPoint mapToParent(const QPoint &) const; 
int maximumHeight() const; 

QSize maximumSize() const; 
int maximumWidth() const; 

QRect microFocusHint() const; 
int minimumHeight() const; 

QSize minimumSize() const; 
virtual QSize minimnmSizeHint() const; 
int minimumWidth() const; 
static QWidget *mouseGrabber(); 
const QPalette & palette() const; 

PropagationMode palettePropagation() const; 

QWidget *parentWidget() const; 

QPoint pos() const; 

void recreate(QWidget *parent, WFlags f, const QPoint &p, bool showlt = FALSE); 
QRect rect() const; 
void releaseKeyboard(); 
void releaseMouse(); 

virtual void reparent(QWidget *parent, WFlags, const QPoint &, bool showlt = FALSE); 

void reparent(QWidget *parent, const QPoint &, bool showlt = FALSE); 
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void scroll(int dx, int dy); 

void scroll(int dx, int dy, const QRect &); 

virtual void setAcceptDrops(bool on); 

virtual void setActiveWindow(); 

virtual void setAutoMask(bool); 

virtual void setBackgroundColor(const QColor &); 

virtual void setBackgroundMode(BackgroundMode); 

void setBackgroundOrigin(BackgroundOrigin); 

virtual void setBackgroundPixmap(const QPixmap &); 

void setBaseSize(const QSize &); 

void setBaseSize(int basew, int baseh); 

virtual void setCursor(const QCursor &); 

void setF ixedHeight(int h); 

void setFixedSize(const QSize &); 

void setFixedSize(int w, int h); 

void setFixedWidth(int w); 

virtual void setFocusPolicy(FocusPolicy); 

virtual void setFocusProxy(QWidget *); 

virtual void setFont(const QFont &); 

void setFont(const QFont &, bool iReallyMeanlt); 

virtual void setFontPropagation(PropagationMode); 

virtual void setMask(const QBitmap &); 

virtual void setMask(const QRegion &); 

void setMaximumHeight(int maxh); 

void setMaximumSize(const QSize &); 

virtual void setMaximumSize(int maxw, int maxh); 

void setMaximumWidth(int maxw); 

void setMinimumHeight(int minh); 

void setMinimumSize(const QSize &); 

virtual void setMinimumSize(int minw, int minh); 

void setMinimumWidth(int minw); 

void setName(const char *name); 

virtual void setPalette(const QPalette &); 

void setPalette(const QPalette &, bool iReallyMeanlt); 

virtual void setPalettePropagation(PropagationMode); 

void setSizeIncrement(const QSize &); 






virtual void setSizeIncrement(int w, int h); 
void setStyle(QStyle *); 

static void setTabOrder(QWidget *, QWidget *); 

QSize size() const; 

virtual QSize sizeHint() const; 

QSize sizelncrement() const; 
virtual QSizePolicy sizePolicy() const; 

QStyle & style() const; 

bool testWFlags(WFlags n) const; 

bool testWState(uint n) const; 

QWidget *topLevelWidget() const; 
virtual void unsetCursor(); 
void unsetFont(); 
void unsetPalette(); 
void updateGeometry(); 

QRect visibleRect() const; 
int width() const; 

WId winld() const; 
static QWidgetMapper *wmapper(); 
int x() const; 
int y() const; 

처리부 

void clearFocus(); 
bool close(); 
void constPolish() const; 
virtual void hide(); 
void iconify(); 
void lower(); 

virtual void move(int x, int y); 

void move(const QPoint &); 

virtual void polish(); 

void raise(); 

void repaint(); 

void repaint(bool erase); 

void repaint(int x, int y, int w, int h, bool erase = TRUE); 


void repaint(const QRect &, bool erase = TRUE); 
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void repaint(const QRegion &, bool erase = TRUE); 

virtual void resize(int w, int h); 

void resize(const QSize &); 

virtual void setCaption(const QString &); 

virtual void setEnabled(bool); 

virtual void setFocus(); 

virtual void setGeometry(int x, int y, int w, int h); 
virtual void setGeometry(const QRect &); 
virtual void setIcon(const QPixmap &); 
virtual void setlconText(const QString &); 
virtual void setMouseTracking(bool enable); 
virtual void setUpdatesEnabled(bool enable); 
virtual void show(); 
void showFullScreen(); 
virtual void showMaximized(); 
virtual void showMinimized(); 
virtual void showNormal(); 
void update(); 

void update(int x, int y, int w, int h); 
void update(const QRect &); 

렬거형 

enum BackgroundMode { FixedColor, FixedPixmap, NoBackground, PaletteForeground, PaletteButton, 
PaletteLight, PaletteMidlight, PaletteDark, PaletteMid, PaletteText, PaletteBrightText, 
PaletteBase, PaletteBackground, PaletteShadow, PaletteHighlight, PaletteHighlightedText }; 
enum PropagationMode { NoChildren, AllChildren, SameFont, SamePalette=SameFont}; 
enum FocusPolicy {NoFocus=0, TabFocus=Oxl, ClickFocus=0x2, StrongFocus=0x3, 

WheelFocus=0x7 }; 

enum BackgroundOrigin { WidgetOrigin, ParentOrigin }; 


QWidgetStack 

QWidgetStack 창문부품은 한번에 1 개 창문부품만 현시 하는 용기이다. 
머리 부파일 

#include <qwidgetstack.h> 

기초클라스 


QFrame QObject QPaintDevice Q Widget Qt 





구성자 


QWidgetStack(QWidget *parent = 0， const char *name = 0); 

메쏘드 

void addWidget(QWidget * ， int); 
int id(QWidget *) const; 

QSize minimumSizeHint() const; 
void removeWidget(QWidget *); 
void setF rameRect(const QRect &); 
void show(); 

QSize sizeHint() const; 

QWidget *visibleWidget() const; 

QWidget *widget(int) const; 

처 리 부 

void raiseWidget(int); 
void raiseWidget(QWidget *); 

신호 

void aboutToShow(int); 
void aboutToShow(QWidget *); 

다음 실례는 QWidg 하 Stack 에 3 개의 QPushButton 창문부품을 창조하여 추가한다. 그림 18- 
29와 같이 현시된 유일한 창문부품은 raiseWidget () 호출에 사용된 식별번호를 가진 창문부품 
이다. 

/* showwidgetstack.cpp */ 

#include <qapplication.h> 

#include <qwidgetstack.h> 

#include <qpushbutton.h> 
int main(int argc，char **argv) 

{ 

QPushButton *button; 

QApplication app(argc,argv); 

QWidgetStack *widgetstack = new QWidgetStack(); 

button = new QPushButton( M First Button", widgetstack); 

widgetstack->addW idget(button, 1); 

button = new QPushButton( M Second Button", widgetstack); 

widgetstack->addWidget(button,2); 

button = new QPushButton( M Third Button", widgetstack); 

widgetstack->addWidget(button,3 )； 
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widgetstack->raiseWidget(2); 

widgetstack->showO ； 

app. setMainWidget(widgetstack); 

retnm(app.exec()); 



그림 18-29. 그 창문부품들중 하나를 현시하는 QWidgetStack 창문부품 

QWizard 

QWizard 창문부품은 여러 단계의 대화칸을 창조하는데 사용한다. 매개 걸음은 하나의 
창문으로 이 루어 져 있다. QWizard 창문부품은 폐 지 화기 구와 조종단추들을 제 공한다. 

머리 부파일 

#include <qwizard.h> 

기초클라스 

QDialog QObject QPaintDevice QWidget Qt 
파생 클라스 
KWizard 
구성 자 

QWizard(QWidget *parent = 0, const char *name = 0, bool modal = FALSE, WFlags f = 0); 

메쏘드 

virtual void addPage(QWidget *，const QString &); 
virtual bool appropriate(QWidget *) const; 

QPushButton *backButton() const; 

QPushButton *cancelButtonO const; 

QWidget *currentPageO const; 
bool eventFilter(QObject *，QEvent *); 

QPushButton *finishButton() const; 

QPushButton *helpButton() const; 

QPushButton *nextButton() const; 

QWidget *page(int pos) const; 

int pageCountO const; 

virtual void removePage(QWidget *); 
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virtual void setAppropriate(QWidget *, bool); 
void setFont(const QFont &font); 
void show(); 

virtual void showPage(QWidget *); 

QString title(QWidget *) const; 

처러부 

virtual void setBackEnabled(QWidget *, bool); 
virtual void setFinish(QWidget *, bool); 
virtual void setFinishEnabled(QWidget *, bool); 
virtual void setHelpEnabled(QWidget *, bool); 
virtual void setNextEnabled(QWidget *, bool); 

신호 

void helpClicked(); 

다음 실례는 그림 18-30 에 보여주는 빈 QWizard 창문부품을 현시한다. 

/* showwizard.cpp */ 

#include <qapplication.h> 

#include <qwizard.h> 

int main(int argc’char **argv) 

{ 

QPushButton *button; 

Q Application app(argc,argv); 

QWizard * wizard = new QWizardO ； 
wizard->showO ； 
app. setMainWidget(wizard); 
retum(app. exec()); 



그림 18-30. QWizard 창문부품 
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요 약 

이 장은 모든 Qt 창문부품들을 자모순으로 제공하였다. 매개 창문부품은 다음과 같이 목 
록화하였다. 

• 창문부품의 실례들을 만드는데 사용할수 있는 구성자들. 

• 창문부품이 정의되는 머리부파일의 이름 

• 창문부품이 기능을 계승하는 모든 기초클라스들 

• 창문부품이 기능을 넘겨주는 모든 파생클라스들 

• 1개 창문부품의 사건을 다른 창문부품의 메쏘드호출에 련결하는데 사용되는 처리부와 
신호들 

• 응용프로그람에 사용할수 있는 공개메쏘드 

다음 장은 KDE 창문부품들을 설 명 한다. KDE 창문부품은 QWidget 로부터 계 승된 KDE 클라 
스이다. 




제 19 장. KDE 으| 창문부품 


학습내용 

매개 창문부품의 구성자들, 필요한 머리부파일，기초클라스와 파생클라스들, 처리 
부와 신호들 그리고 모든 공개메쏘드들 

창문부품의 작은 실례들. 

이 장은 모든 창문부품들을 자모순으로 제시한다. 창문부품은 현시가능한 창문을 포함 
하는 클라스이다. KDE 에서 현시가능한 창문을 가지는 모든 클라스는 QWidget 클라스로부터 
창문기능을 계승한다. 더우기 대부분의 창문부품은 대화칸이다. 즉 QWidget 를 계승하는 
QDialog 로부터 계승된다. 유일한 차이는 창문부품은 부모를 가져야 하고 다른 창문안에 현 
시되며 대화칸은 그 자체의 제 일 웃준위창문을 가지고있다는것 이다. 

매개 창문부품은 머리부파일의 이름，모든 기초클라스들의 이름，모든 KDE 와 Qt 파생클 
라스들의 이름, 공개메 쏘드， 처리부，신호 그리고 렬거형들로 이루어진다. 

일부 기초 및 파생클라스들을 제외한 모든 창문부품들은 실례가 있다. 매개 창문부품에 
제 공된 실 례 코드는 창문부품의 현시 가능한 폼을 만든다. 일부 창문부품들은 제 일 웃준위창 
문부품으로서 지정되고 기본창문으로 현시된다. 그러나 일부 특수창문부품은 특수한 환경에 
서 포함된다. 


KAboutContainer 

KAboutContainer 는 자체 의 About 칸을 구성 하는 골격 창문부품이 다. 

머리 부파일 

#include <kaboutdialog.h> 

기 초클라스 

QFrame QObject QPaintDevice QWidget Qt 
구성 자 

KAboutContainer(QWidget *parent = 0， const char *name = 0， int margin = 0， int spacing = 0 ， 
int childAlignment = AlignCenter, int innerAlignment = AlignCenter); 

메쏘드 

void addImage(const QString &fileName, int alignment = AlignLeft); 

void addPerson(const QString &name, const QString &email, const QString &url, const QString &tas 

k, 

bool showHeader = false, bool showframe = false, bool showBold = false); 
void addTitle(const QString &title, int alignment = AlignLeft, bool showframe = false, 
bool showBold = false); 
void addWidget(QWidget * widget); 
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virtual QSize minimumSizeHint(void) const; 
virtual QSize sizeHint(void) const; 

신호 

void mailClick(const QString &name, const QString &address); 
void urlClick(const QString &url); 

KAboutContainer 창문부품은 기정으로 창문에 아무것도 현시 하지 않지만 자기 응용프로 
그람이 필요한만큼 많은 요소들을 추가하는 메쏘드들의 모임을 제공한다. 다음의 실례는 그 
림 19-1 에 보여주는 창문을 만들고 중심에 본문과 개인정보블로크를 추가한다. 

/* showaboutcontainer. cpp */ 

#include <kapplication.h> 

#include <kaboutdialog.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "aboutcontainer"); 

KAboutContainer *aboutcontainer = new KAboutContainerO ； 
aboutcontainer->addTitle( M A title is a line (or block)\n" 

"of text that is stored in the window An", 

Qt::AIignCenter); 

aboutcontainer->addPerson( M Phillip Space", ” phil@nobody.com” ， ” http://www.belugalake.com ”， 

"Responsible for coloring pixels"); 
aboutcontainer->showO ； 

app. setMainWidget(aboutcontainer); 
retum(app. exec()); 



그림 19-1. 두 항목을 현시하는 KAboutContainer 창문부품 
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KAboutContainerBase 

KAboutContainerBase 창문부품은 하나이 상의 KAboutContainer 창문부품들을 적당한 장소에 
배 치 하고 현시할수 있 다. 

머리 부파일 

#include <kaboutdialog.h> 

기 초클라스 

QObject QPaintDevice QWidget Qt 

구성 자 

KAboutContainerBase(int layoutType, QWidget *parent = 0， char *name = 0); 

메쏘드 

KAboutContainer *addContainer(int childAlignment, int inner Alignment); 

KAboutContainer *addContainerPage(const QString &title, int childAlignment = AlignCenter, 
int inner Alignment = AlignCenter); 

QFrame *addEmptyPage(const QString &title); 

QFrame *addTextPage(const QString &title, const QString &text, bool richText = false, 
int numLines = 10); 

void setImage(const QString &fileName); 

void setImageBackgroundColor(const QColor &color); 

void setlmageFrame(bool state); 

void setProduct(const QString &appName, const QString &version, const QString &author, 
const QString &year); 
void setTitle(const QString &title); 
virtual void show(void); 
virtual QSize sizeHint(void) const; 

처리부 

virtual void slotMailClick(const QString &name, const QString &address); 
virtual void slotMouseTrack(int mode, const QMouseEvent *e); 
virtual void slotUrlClick(const QString &url); 

신호 

void mailClick(const QString &name, const QString &address); 
void mouseTrack(int mode, const QMouseEvent *e); 
void urlClick(const QString &url); 

렬거형 

enum LayoutType { AbtPlain=0x0001, AbtTabbed=0x0002, AbtTitle=0x0004, AbtImageLeft=0x0008, 

AbtImageRight=0x0010, Abtlmage0nly=0x0020, AbtProduct=0x0040, 
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AbtKDEStandard=AbtTabbed|AbtTitle|AbtImageLeft, AbtAppStandard=AbtTabbed|AbtTitle|AbtProduct, 
AbtImageAndTitle=AbtPlain|AbtTitle|AbtImageOnly }; 

KAboutContainerBase 창문부품을 사용하는 실례는 5장에 있다 (KAboutDialog 에서). 

KAboutContributor 

KAboutContributor 창문부품은 About 칸에 현시 할 개 별적 인 공헌자의 이 름과 기 타 정 보를 
표준형 식 으로 제 시한다. 

머리 부파일 

#include <kaboutdialog.h> 

기초클라스 

QFrame QObject QPaintDevice QWidget Qt 

구성자 

KAboutContributor(QWidget *parent = 0, const char *name = 0, const QString &usemame = QString:: 

null, 

const QString &email = QString::null, const QString &url = QString: :null, 

const QString &work = QString: :null, bool showHeader = false, bool showFrame = true, 

bool showBold = false); 

메쏘드 

QString getEmail(void); 

QString getName(void); 

QString getURL(void); 

QString getWork(void); 

void setEmail(const QString &text, const QString &header = QString::null, bool update = true); 
void setName(const QString &text, const QString &header = QString: :null, bool update = true); 
void setURL(const QString &text, const QString &header = QString::null, bool update = true); 
void setWork(const QString &text, const QString &header = QString::null, bool update = true); 
virtual QSize sizeHint(void) const; 

신호 

void openURL(const QString &url); 

void sendEmail(const QString &name, const QString &email); 

다음의 실례는 그림 19-2 에 보여 주는 KAboutConttibutor 창문부품을 만들고 현시한다. 

/* showaboutcontributor.cpp */ 

#include <kapplication.h> 

#include <kaboutdialog.h> 
int main(int argc’char **argv) 
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{ 


KApplication app(argc,argv, "aboutcontributor"); 

KAboutContributor *aboutcontributor = new KAboutContributor(0,0, "Phillip Space", 
”phil@nobody.com” ， ”http:/ 八 vww.behigalake.com”，’’Responsible for coloring pixels"); 
aboutcontributor->showO ； 
app. setMainWidget(aboutcontributor); 
retum(app. exec()); 



그림 19-2. 개인정보를 현시하는 KAboutCon 仕 ibutor 창문부품 

KAboutDialog 

KAboutDialog 창문부품은 응용프로그람에 대한 정보를 현시하는 튀여나오기대화칸이다. 

머 러 부파일 

#include <kaboutdialog .h> 

기초클라스 

KDialog KDialogBase QDialog QObject QPaintDevice QWidget Qt 

파생 클라스 

KAboutKDE 

구성자 

KAboutDialog(QWidget *parent = 0, const char *name = 0, bool modal = true); 

KAboutDialog(int dialogLayout, const QString &caption, int buttonMask, ButtonCode defaultfiutton, 

QWidget *parent = 0, const char *name = 0, bool modal = false, bool separator = false, 
const QString &userl = QString::null, const QString &user2 = QString: :null, 
const QString &user3 = QString::null); 

메쏘드 

KAboutContainer *addContainer(int childAlignment, int inner Alignment); 

KAboutContainer *addContainerPage(const QString &title, int childAlignment = AlignCenter, 
int innerAlignment = AlignCenter); 

void addContributor(const QString &name, const QString &email, const QString &url, const QString 


&work); 
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QFrame *addPage(const QString &title); 

QFrame *addTextPage(const QString &title, const QString &text, bool richText = false, 
int numLines = 10); 
void adjust(); 

static void imageURL(QWidget *parent, const QString &caption, const QString &path, 
const QColor &imageColor, const QString &url); 

void setAuthor(const QString &name, const QString &email, const QString &url, const QString &wor 

k); 

void setImage(const QString &fileName); 
void setImageBackgroundColor(const QColor &color); 
void setlmageFrame(bool state); 
void setLogo(const QPixmap &); 

void setMaintainer(const QString &name, const QString &email, const QString &url, const QString & 

work); 

void setProduct(const QString &appName, const QString &version, const QString &author, 
const QString &year); 
void setTitle(const QString &title); 
void setVersion(const QString &name); 
virtual void show(void); 
virtual void show(QWidget *centerParent); 

신호 

void openURL(const QString &url); 

void sendEmail(const QString &name, const QString &email); 

렬거형 

enum LayoutType { AbtPlain=0x0001, AbtTabbed=0x0002, AbtTitle=0x0004, AbtTmageLefH)x0008, 
AbtImageRight=0x0010, Abtlmage0nly=0x0020, AbtProduct=0x0040, 

AbtKDEStandard=AbtTabbed|AbtTitle|AbtImageLeft, AbtAppStandard=AbtTabbed|AbtTitle|AbtProduct, 
AbtImageAndTitle=AbtPlain|AbtTitle| Abtlmage^ }; 

5 장에 KAboutDialog 의 실례가 있다. 

KAboutKDE 

KAboutKDE 대화칸은 KAboutDialog 에 기초하며 표준 KDE 형식으로 현시 하도록 구성된다. 
머리 부파일 

#include <kaboutkde.h> 


기초클라스 


533 




KAboutDialog KDialog KDialogBase QDialog QObject 
QPaintDevice QWidget Qt 


구성 자 

KAboutKDE(QWidget *parent = 0, const char *name = 0, bool modal = true); 

KAboutDialog 의 KDE 표준형식을 보여주는 실례는 5장에 있다. 

KAboutWidget 

KAboutWidget 는 여러 형식들중 하나로 응용프로그람정보를 현시하며 현시정보를 삽입 
하는데 쓰이는 메쏘드모임을 제공한다. 이것은 KAboutDialog 의 기본창문부품이다. 

머리 부파일 

#include <kaboutdialog.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

구성자 

KAboutWidget(QWidget *parent = 0， const char *name = 0); 

메쏘드 

void addContributor(const QString &name, const QString &email, const QString &url, 
const QString &work); 
void adjust(); 

void setAuthor(const QString &name, const QString &email, const QString &url, 
const QString &work); 
void setLogo(const QPixmap &); 

void setMaintainer(const QString &name, const QString &email, const QString &url, 
const QString &work); 
void setVersion(const QString &name); 

신호 

void openURL(const QString &url); 

void sendEmail(const QString &name, const QString &email); 

5 장에 KAboutWidget 를 KAboutDialog 의 기본창문부품으로 사용하는 실례가 있다. 

KAccelMenu 

KAccelMenu 창문부품은 KAccel 과 KKeyDialog 의 사용을 간단화하는 파생클라스이다. 

머리 부파일 

#include <kaccelmenu.h> 
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기 초클라스 

QFrame QMenuData QObject QPaintDevice QPopupMenu QWidget Qt 

구성 자 

KAccelMenu(KAccel *k, QWidget *parent = 0， const char *name = 0); 

메쏘드 

int insItem(const QPixmap &pixmap, const char *text, const char *action, const QObject *receiver, 
const char *member, const char *accel = 0); 

int insItem(const char *text, const char * action, const QObject *receiver, const char *member, 
const char *accel = 0); 

int insItem(const QPixmap &pixmap, const char *text, const char *action, const QObject *receiver, 
const char *member, KStdAccel :: StdAccel accel); 

int insItem(const char *text, const char * action, const QObject *receiver, const char *member, 
KStdAccel:: StdAccel accel); 


KAnimWidget 

KAnimWidget 는 개 별적 인 픽 스매프들을 차례로 현시함으로써 동화를 생성 한다. 

머리 부파일 

#include <kanimwidget.h> 

기 초클라스 

QFrame QObject QPaintDevice QWidget Qt 

구성 자 

KAnimWidget(const QStringList &icons, int size = 0, QWidget *parent = 0L, const char *name = 0L); 
KAnimWidget(QWidget *parent = 0L, const char *name = 0L); 

메쏘드 

void setIcons(const QStringList &icons); 
void setSize(int size); 
void start(); 
void stop(); 

신호 

void clicked(); 

다음의 실례는 그림 19-3 에 보여진 창문을 현시하고 flagl . png 로부터 flag 4. png 라는 이름 
의 픽 스매 프들을 적 재 하여 프레 임 들의 동화렬로서 현시 한다. share / icons / small 등록부들에 서 그 
림기호파일들을 탐색하고 pics 등록부에서 응용프로그람을 찾는다. 이 실례는 

〜 /. kde / animwidget / pics 에서 파일들을 찾는다. 

/* showanimwidget. cpp */ 
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#include <kapplication.h> 

#include <kanimwidget.h> 

#include <qstringlist.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "animwidget"); 

QStringList icons; 

Q Widget * widget = new QWidgetO ； 
icons. append(" flag 1”); 
icons.append (” flag2”); 
icons. append("flag3”); 
icons, append (” flag4’，); 

KAnimWidget *kanimwidget = new KAnimWidget(icons,0,widget); 

kanimwidget->start(); 

widget->showO ； 

app. setMainWidget(widget); 

retum(app. exec()); 

} 

一 • □ x 



그림 19-3. KAnimWidget 가 관리 하는 동화렬 의 한개 프레 임 

KAuthlcon 

KAuthlcon 창문부품은 사용자가 어떤 작용을 수행할 능력을 가지는가를 가리키도록 설 
계된 창문부품들의 기초클라스이다. 

머리 부파일 

#include <kauthicon.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

파생 클라스 

KRootPermsIcon KWritePermsIcon 

구성 자 

KAuthIcon(QWidget *parent = 0, const char *name = 0); 

메쏘드 





virtual QSize sizeHint() const; 
virtual bool status() const = 0; 

처 리 부 

virtual void updateStatus() = 0; 

신호 

void authChanged(bool authorized); 


KB 니 gReport 

KBugReport 는 사용자로부터 오유보고를 받아들이는 대화칸의 기초클라스이다. 

KHelpMenu 가 KBugReport 대화칸을 만들므로 이것들중의 하나를 창조할 필요는 없다. 

머리 부파일 

#include <kbugreport.h> 

기 초클라스 

KDialog KDialogBase QDialog QObject QPaintDevice QWidget Qt 

구성 자 

KBugReport(QWidget *parent = 0L, bool modal = true, const KAboutData *aboutData = 0L); 

KButtonBox 

KButtonBox 는 수직 으로 또는 수평 으로 조직 화된 단추그룹을 보유하는 용기 이 다. 

머리 부파일 

#include <kbuttonbox.h> 

기 초클라스 

QObject QPaintDevice QWidget Qt 

구성 자 

KButtonBox(QWidget *parent, int orientation = HORIZONTAL, int border = 0, int autoborder = 6); 

메쏘드 

QPushButton *addButton(const QString &text, bool noexpand = FALSE); 
void addStretch(int scale = 1); 
void layout(); 

virtual void resizeEvent(QResizeEvent *); 
virtual QSize sizeHint() const; 

렬거형 

enum (anon) { VERTICAL=1, HORIZONTAL=2 }; 

7 장에 KButtonBox 의 실례가 있다. 




KCharSelect 


KCharSelect 창문부품은 사용자가 서체를 선택하고 서체로부터 하나의 문자를 선택한다 . 
머리 부파일 

#include <kcharselect.h> 

기초클라스 

QFrame QHBox QObject QPaintDevice QVBox QWidget Qt 

구성자 

KCharSelect(QWidget *parent, const char *name, const QString &font = QString::null, 
const QChar &chr = , int tableNum = 0); 

메쏘드 

virtual QChar chr(); 

virtual void enableFontCombo(bool e); 

virtual void enableTableSpinBox(bool e); 

virtual QString font(); 

virtual bool isFontComboEnabled(); 

virtual bool isTableSpinBoxEnabled(); 

virtual void setChar(const QChar &chr); 

virtual void setFont(const QString &font); 

virtual void setTableNnm(int tableNum); 

virtual QSize sizeHint() const; 

virtual int tableNum(); 

신호 

void activated(const QChar &c); 

void activated。; 

void focusItemChanged(); 

void focusItemChanged(const QChar &c); 

void fontChanged(const QString &_font); 

void highlighted(const QChar &c); 

void highlighted。; 

다음의 실례는 그림 19-4 에 보여 주는 KCharSelect 창문을 현시한다. 

/* showcharselect, cpp */ 

#include <kapplication.h> 

#include <kcharselect.h> 

#include <qstring.h> 

int main(int argc,char **argv) 
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{ 


KApplication app(argc,argv, "showcharselect"); 

Q Widget * widget = new QWidgetO ； 

KCharSelect *kcharselect = new KCharSelect(widget, "charselect"); 

kcharselect->resize(kcharselect->sizeHintO )； 

widget->resize(kcharselect->sizeHintO )； 

widget->showO ； 

app. setMainWidget(widget); 

retum(app. exec()); 


| 광명 | 


Table: [o ^ Unicode code point： 0020 
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그림 19-4. 하나의 서체와 문자를 선택한 KCharSelect 창문부품 


KCharSelectTable 

KCharSelectTable 창문부품은 KCharSelect 창문부품의 문자현시부분이다. 

머리 부파일 

#include <kcharselect.h> 

기초클라스 

QFrame QObject QPaintDevice QTableView QWidget Qt 

구성 자 

KCharSelectTable(QWidget *parent, const char *name, const QString &_font, const QChar &_chr, 
int tableNum); 

메쏘드 

virtual QChar chr(); 

virtual void setChar(const QChar &_chr); 
virtual void setFont(const QString &_font); 
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virtual void setTableNum(int tableNum); 
virtual QSize sizeHint() const; 

신호 

void activated(const QChar &c); 

void activated(); 

void focusItemChanged(); 

void focusItemChanged(const QChar &c); 

void highlighted(const QChar &c); 

void highlighted(); 

void tableDown(); 

void tableUp(); 

실례로 KCharSelect 를 보시오. 

KCModule 

KCModule 창문부품은 모든 조종모들들의 기초클라스이다. 결과의 창문부품은 kcon 仕이창 
문중의 하나로 나타나며 환경설정값을 조정하는데 쓰인다. 

머리 부파일 

#include <kcmodule.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

구성 자 

KCModule(QWidget *parent = 0， const char *name = 0) 

: QWidget( parent ， name ) ， _btn ( Help | Default | Reset | Cancel | Apply | Ok ); 

메쏘드 

int buttons(); 
virtual void defaults(); 
static void init(); 
virtual void loadO ； 
virtual QString quickHelp(); 
virtual void save(); 
virtual void sysdefaults(); 

신호 

void changed(bool state); 

렬거형 


enum Button { Help=l, Default=2, Reset=4, Cancel=8, Apply=16, Ok=32, SysDefault=64 }; 




KColorButton 


KColorButton 창문부품은 색칠된 누름단추이며 선택하였을 때 사용자가 다른 색을 선택 
할수 있게 하는 대화칸을 펼친다. 

머리 부파일 

#include <kcolorbtn.h> 

기 초클라스 

QButton QObject QPaintDevice QPushButton QWidget Qt 

구성 자 

KColorButton(QWidget *parent, const char *name = OL); 

KColorButton(const QColor &c, QWidget *parent, const char *name = OL); 

메쏘드 

const QColor color() const; 
void setColor(const QColor &c); 

신호 

void changed(const QColor &newColor); 

다음의 실례는 붉은색의 KColorButton 을 만든다. 그림 19-5 에 보여준것처럼 단추를 선택 
하면 대화칸이 나나난다. 그다음 사용자가 다른 색을 선택하면 KColorButton 의 색을 변경하 
고 changed () 신호를 발생시킨다. 

/* showcolorbutton.cpp */ 

#include <kapplication.h> 

#include <kcolorbtn.h> 

#include <qcolor.h> 

int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, " showcolorbutton"); 

KColorButton *colorbutton = new KColorButton(0, "colorbutton"); 
colorbutton->setColor(QColor("red "))； 

colorbutton->resize(colorbutton->sizeHint()); 

colorbutton->show(); 

app. setMainW idget(colorbutton); 

retnm(app.exec()); 




KColorCells 

KColorCells 창문부품은 색모임을 현시하고 사용자가 그것들중 하나를 선택하게 한다 . 
머 리 부파일 

#include <kcolordlg.h> 

기초클라스 

QFrame QObject QPaintDevice QTableView QWidget Qt 

구성자 

KColorCells(QWidget *parent, int rows, int cols); 

메쏘드 

QColor color(int indx); 
int getSelectedO ； 
int numCells(); 

void setAcceptDrags(bool acceptDrags); 
void setColor(int colNum, const QColor &col); 
void setShading(bool shade); 


신호 
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void colorSelected(int col); 

다음의 실례는 그림 19-6 에 보여 주는 색세포목록을 현시한다. 

/* showcolorcells.cpp */ 

#include <kapplication.h> 

#include <kcolordlg.h> 

int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showcolorcells"); 

KColorCells *colorcells = new KColorCells(0,1,5); 

colorcells^setColo^OjQColorC'magenta")); 

colorcells- 〉 setColor( 1 ,QColor( ， ’red”)); 

colorcells->setColor(2,QColor( M blue M )); 

colorcells->setColor(3,QColor( M green M )); 

colorcells->setColor(4,QColor( M cyan")); 

colorcells- 〉 show() ； 

app. setMainWidget(colorcells); 

retum(app. exec()); 



그림 19-6. 5 가지 색들의 렬을 보여주는 KColorCells 창문부품 

KColorCombo 

KColorCombo 창문부품은 마우스로 선택하기 위한 내 리펼침 형의 색목록을 현시한다. 
머리 부파일 

#include <kcolordlg.h> 

기초클라스 

QComboBox QObject QPaintDevice QWidget Qt 

구성 자 

KColorCombo(QWidget *parent, const char *name = OL); 

메쏘드 

void setColor(const QColor &col); 

처 리 부 

543 





void slotActivated(int index); 
void slotHighlighted(int index); 

신호 

void activated(const QColor &col); 
void highlighted(const QColor &col); 

다음의 실례는 KColorCombo 창문부품을 현시한다. 그림 19-7 은 KColorCombo 창문부품이 
펼쳐지고 색이 선택된 후의 상태를 보여준다. 

/* showcolorcombo.cpp */ 

#include <kapplication.h> 

#include <kcolordlg.h> 

int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, " showcolorcombo"); 

KColorCombo *colorcombo = new KColorCombo(0, "colorcombo"); 

colorcombo->showO ； 

app. setMainWidget(colorcombo); 


retum(app. exec()); 

} 



그림 19-7. 목록으로부터 색을 선택할수 있는 KColorCombo 창문부품 


KColorDialog 

KColorDialog 은 사용자정의 색을 비 롯한 여 러 가지 특성 을 가지 는 색선택대화칸이 다. 
머 러 부파일 

#include <kcolordlg.h> 

기초클라스 

KDialog KDialogBase QDialog QObject QPaintDevice QWidget Qt 

구성자 

KColorDialog(QWidget *parent = OL, const char *name = OL, bool modal = FALSE); 

메쏘드 

QColor color(); 

static int getColor(QColor & 仕 leColor, QWidget *parent = OL); 
static QColor grabColor(const QPoint &p); 




void setColor(const QColor &col); 


신호 

void colorSelected(const QColor &col); 

11 장에 KColorDialog 창문부품의 실례가 있다. 

KColorPatch 

KColorPatch 창문부품은 색의 직4각형구역을 현시하고 마우스선택에 응답한다. 

머리 부파일 

#include <kcolordlg.h> 

기 초클라스 

QFrame QObject QPaintDevice QWidget Qt 

구성 자 

KColorPatch(QWidget *parent); 

메쏘드 

void setColor(const QColor &col); 

신호 

void colorChanged(const QColor &); 

다음의 실례는 그림 19-8 에 보여주는것처 럼 색령역을 현시하기 위하여 KColorPatch 창문 
부품을 제 일 웃준위창문으로 사용한다. 

/* showcolorpatch.cpp */ 

#include <kapplication.h> 

#include <kcolordlg.h> 

int main(int argc’char **argv) 

{ 

KApplication app(argc,argv, " showcolorpatch"); 

KColorPatch *colorpatch = new KColorPatch(O); 

colorpatch->setColor(QColor( M blue M )); 

colorpatch->show(); 

app. setMainWidget(colorpatch); 

retum(app. exec()); 

} 




그림 19-8. 색 령역을 보여주는 KColorPatch 

KComboBox 

KComboBox 창문부품은 사용자가 목록으로부터 선택할수 있는 단추로서 늘 웃끝에 현재 
항목을 현 시한다. 

머리 부파일 

#include <kcombobox.h> 

기초클라스 

KCompletionBase QComboBox QObject QPaintDevice QWidget Qt 

파생 클라스 

KFileComboBox KFileFilter KURLComboBox 

구성자 

KComboBox(QWidget *parent = 0， const char *name = 0); 

KComboBox(bool rw, QWidget *parent = 0， const char *name = 0); 

메쏘드 

bool autoCompletion() const; 
int cursorPosition() const; 
bool isContextMenuEnabledO const; 
bool isEditableO const; 

virtual void setAutoCompletion(bool autocomplete); 
virtual void setEnableContextMenu(bool showMenu); 

처리부 

void rotateText(KeyBindingType); 

신호 

void completion(const QString &); 
void nextMatch(KeyBindingType); 
void previousMatch(KeyBindingType); 


546 




void retumPressed(); 
void retumPressed(const QString &); 
void rotateDown(KeyBindingType); 
void rotateUp(KeyBindingType); 

다음의 실례는 4 개 항목을 가지는 KComboBox 를 만든다. 그림 19-9 는 마우스로 목록을 
펼친 후 기정으로 3번째 항목을 선택한 창문부품을 보여준다. 

/* showcombobox.cpp */ 

#include <kapplication.h> 

#include <kcombobox.h> 

const char *list[] = { "First Selection”, "Second Selection”，"Third Selection”，"Fourth Selection” }; 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showcombobox”); 

KComboBox *combobox = new KComboBoxQ; 

combobox->insertStrList(list,4); 

combobox- 〉 show(); 

app. setMainW idget(combobox); 
retnm(app.exec()); 

} 



그림 19-9. 3 번째 항목을 선택한 KComboBox 

KDatePicker 

KDatePicker 는 사용자에게 달력을 현시하고 마우스로 날자를 선택할수 있게 한다. 
머리 부파일 

#include <kdatepik.h> 

기초클라스 

QFrame QObject QPaintDevice QWidget Qt 

구성 자 

KDatePicker(QWidget *parent = 0, QDate = QDate :: currentDate (), const char * name = 0 ); 

메쏘드 


const QDate & getDate(); 
bool setDate(const QDate &); 
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void setEnabled(bool); 
void setFontSize(int); 

QSize sizeHintO const; 

신호 

void dateChanged(QDate); 
void dateEntered(QDate); 
void dateSelected(QDate); 
void tableClickedO ； 

다음의 실례는 제 일 웃준위창문으로서 KDatePicker 창문부품을 현시 한다. 그림 19-10 에 
보여준것처럼 웃끝의 왼쪽과 오른쪽 화살표들은 월과 년을 변경하는데 사용할수 있다. 날자 
를 달력으로부터 선택한다. KDatePicker 창문크기가 변경되면 달력과 매개 부분의 크기도 변 
경되므로 전체는 그 형태를 유지한다. 

/* showdatepicker.cpp */ 

#include <kapplication.h> 

#include <kdatepik.h> 

int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, " showdatepicker"); 

KDatePicker *datepicker = new KDatePicker(); 

datepicker->resize(datepicker->sizeHintO )； 

datepicker->showO ； 

app. setMainWidget(datepicker); 

retum(app. exec()); 



그림 19-10. KDatePicker 창문부품 
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KDateTable 


KDateTable 은 한달을 현시 하고 사용자가 마우스로 날자를 선 택할수 있게 한다. 

머리 부파일 

#include <kdatetbl.h> 

기초클라스 

QFrame QObject QPaintDevice QTableView QWidget Qt 

구성자 

KDateTable(QWidget *parent = 0， QDate date = QDate :: currentDate () ， const char * name = 0 ， 
WFlags f=0); 

메쏘드 

const QDate & getDate(); 
bool setDate(const QDate &); 
void setFontSize(int size); 

QSize sizeHint() const; 

신호 

void dateChanged(QDate); 
void tableClicked(); 

KDateTable 창문부품은 독립 형 날자선택기 가 아니 라 KDatePicker 와 같은 다른 창문부품 
의 구성요소이다. 그림 19-11 에 보여주는것처럼 월이름이 현시되지 않는다. 

/* showdatetable.cpp */ 

#include <kapplication.h> 

#include <kdatetbl.h> 

int main(int argc’char **argv) 

{ 

KApplication app(argc,argv, "showdatetable"); 

KDateTable *datetable = new KDateTable(); 
datetable->show(); 
app.setMainWidget(datetable); 
retum(app.exec()); 

} 
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그림 19-ll.KDateTable 창문부품 


KDialog 

KDMog 창문부품은 이행허용 KDE 창문부품들의 기초클라스로서 QDialog 를 확장하여 대화칸 
용 표준 KDE 메쏘드모임을 포함한다. 이것은 KDialogBase 가 구축되는 기초클라스이다. 

머리 부파일 

#include <kdialog.h> 

기초클라스 

QDialog QObject QPaintDevice QWidget Qt 

파생 클라스 

KAboutDialog KAboutKDE KBugReport KColorDialog KCookieWin KDialogBase KEdFind KEdGotoL 
ine 

KEdReplace KEditToolbar KFileDialog KFileDialogConfigureDlg KFontDialog KIconDialog KKeyDialo 
g 

KLineEditDlg KPasswordDialog KTextPrintDialog KURLRequesterDlg KabAPI 

구성자 

KDialog(QWidget *parent = 0, const char *name = 0, bool modal = false, WFlags f = 0); 

메쏘드 

static int marginHint(); 

static void resizeLay out(Q W idget * widget, int margin, int spacing); 
static void resizeLayout(QLayoutItem *lay, int margin, int spacing); 
static int spacingHint(); 

처 리 부 

virtual void setCaption(const QString &caption); 
virtual void setPlainCaption(const QString &caption); 

신호 


void layoutHintChanged(); 
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KDialogBase 

KDialogBase 는 KDE 에서 대화칸을 만드는 기초클라스로서 대화칸용의 표준 KDE 단추모 
임을 포함한다. 

머리 부파일 

#include <kdialogbase.h> 

기 초클라스 

KDialog QDialog QObject QPaintDevice QWidget Qt 

파생 클라스 

KAboutDialog KAboutKDE KBugReport KColorDialog KCookieWin KEdFind KEdGotoLine KEdRepla 

KEdi 付 oolbar KFileDialog KFileDialogConfigureDlg KFontDialog KIconDialog KKeyDialog KLineEdit 
Dig 

KPasswordDialog KTextPrintDialog KURLRequesterDlg KabAPI 

구성 자 

KDialogBase(QWidget *parent = 0 ， const char *name = 0 ， bool modal = true, 

const QString &caption = QString::null, int buttonMask = Ok | Apply | Cancel, 

ButtonCode defaultButton = Ok, bool separator = false, const QString &userl = QString: :null, 
const QString &user2 = QString::null, const QString &user3 = QString: :null); 

KDialogBase(int dialogFace, const QString &caption, int buttonMask, ButtonCode defaultButton, 
QWidget *parent = 0, const char *name = 0, bool modal = true, bool separator = false, 
const QString &userl = QString: :null, const QString &user2 = QString: :null, 
const QString &us 여 3 = QString::null); 

KDialogBase(const QString &caption, int buttonMask = Yes | No | Cancel, 

ButtonCode defaultButton = Yes, ButtonCode escapeButton = Cancel, QWidget *parent = 0, 
const char *name = 0, bool modal = true, bool separator = false, QString yes = QString: :null, 

QString no = QString::null, QString cancel = QString::null); 

메쏘드 

QPushButton *actionButton(ButtonCode id); 

int activePageIndex() const; 

QGrid *addGridPage(int n, QGrid::Direction dir, const QString &itemName, 

const QString &header = QString: :null, const QPixmap &pixmap = QPixmap () ); 

QHBox *addHBoxPage(const QString &itemName, const QString &header = QString::null, 
const QPixmap &pixmap = QPixmap () ); 

QFrame *addPage(const QString &item, const QString &header = QString: :null, 


const QPixmap &pixmap = QPixmap 0 ); 
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QVBox *addVBoxPage(const QString &itemName, const QString &header = QString::null, 
const QPixmap &pixmap = QPixmap () ); 
virtual void adjustSize(); 

QSize calculateSize(int w, int h); 

void delayedDestruct(); 

void disableResize(); 

void enableButtonSeparator(bool state); 

static const QPixmap *getBackgroundTile(); 

void getBorderWidths(int &ulx, int &uly, int &lrx, int &lry) const; 

QRect getContentsRect(); 

QWidget *getMainWidget(); 
static bool haveBackgroundTile(); 

QString helpLinkText(); 

void incInitialSize(const QSize &s, bool noResize = false); 

QGrid *makeGridMainWidget(int n, QGrid::Direction dir); 

QHBox *makeHBoxMainWidgetO ； 

QFrame *makeMainWidget(); 

QVBox *makeVBoxMainWidgetO ； 
int pageIndex(QWidget *widget) const; 

QFrame *plainPage(); 

static void setBackgroundTile(const QPixmap *pix); 

void setButtonApplyText(const QString &text = QString: :null, const QString &tooltip = QString: :null, 
const QString &quickhelp = QString: :null); 

void setButtonCancelText(const QString &text = QString: :null, const QString &tooltip = QString: :null, 
const QString &quickhelp = QString: :null); 

void setButtonOKText(const QString &text = QString::null, const QString &tooltip = QString::null, 
const QString &quickhelp = QString: :null); 
void setButtonText(ButtonCode id, const QString &text); 
void setButtonTip(ButtonCode id, const QString &text); 
void setButtonWhatsThis(ButtonCode id, const QString &text); 
void setIconListAllVisible(bool state); 
void setInitialSize(const QSize &s, bool noResize = false); 
void setMainW idget(Q Widget * widget); 
void setTreeListAutoResize(bool state); 
void showButton(ButtonCode id, bool state); 
void showButtonApply(bool state); 
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void showButtonCancel(bool state); 
void showButtonOK(bool state); 
bool showPage(int index); 
void showTile(bool state); 

처 리 부 

void enableButton(ButtonCode id, bool state); 

void enableButtonApply(bool state); 

void enableButtonCancel(bool state); 

void enableButtonOK(bool state); 

void enableLinkedHelp(bool state); 

void helpClickedSlot(const QString &); 

void setHelp(const QString &path, const QString &topic); 

void setHelpLinkText(const QString &text); 

void updateBackground(); 

신호 

void apply(); 
void applyClicked(); 
void backgroundChanged(); 
void cancelClicked(); 
void closeClicked(); 
void defaultClicked(); 
void helpClicked(); 
void hidden(); 
void noClicked(); 
void okClicked(); 
void tryClicked(); 
void userlClicked(); 
void user2Clicked(); 
void us 여 SClickedO; 
void yesClicked(); 

렬거형 

enum ButtonCode { Help=0x00000001, Default=0x00000002, 0k=0x00000004, Apply=0x00000008, 
Try=0x00000010, Cancel=0x00000020, Close=0x00000040, User1=0x00000080, 
User2=0x00000100, User3=0x00000200, No=0x00000080, 

Yes=0x00000100, Stretch=0x80000000 }; 

enum ActionButtonStyle { ActionStyle0=0, ActionStylel, ActionStyle2, ActionStyle3, ActionStyle4, 
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ActionStyleMAX }; 


enum DialogType { TreeList=KJanusWidget: : TreeList, Tabbed=KJanusWidget: : Tabbed, 
Plain=KJanusWidget: : Plain, Swallow=KJanusWidget::Swallow, 

IconList=KJanusWidget: :IconList}; 

KDialogBase 를 사용하여 대화칸을 구축하는 실례들이 4장에 있다 

KDialogBaseButton 

KDialogBaseButton 은 KDialogBase 가 내부적으로 사용하며 역호출메쏘드들에서 쓰이는 
단추의 유일식별번호들을 추가한다. 

머리 부파일 

#include <kdialogbase.h> 

기초클라스 

QButton QObject QPaintDevice QPushButton QWidget Qt 

구성자 

KDialogBaseButton(const QString &text, int key, 

QWidget *parent = 0, const char *name = 0); 

메쏘드 

inline int id(); 

4 장에 KDialogBase 를 사용하여 대화칸을 구축하는 실례들이 있다. 

KDockMainWindow 

KDockMainWindow 는 KDockWidget 들이 경계를 따라 류동하게 하는 KMainWindow 의 특 
수판이 다. 

머리 부파일 

#include <kdockwidget.h> 

기초클라스 

KMainWindow KXMLGUIBuilder KXMLGUIClient QObject QPaintDevice QWidget Qt 

구성 자 

KDockMainWindow(const char *name = 0L); 

메쏘드 

void activateDock(); 

KDockWidget *createDockWidget(const QString &name, const QPixmap &pixmap, 

QWidget *parent = 0L); 

QPopupMenu *dockHideShowMenu(); 

KDockWidget *getMainDockWidget(); 
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void makeDockInvisible(KDockWidget *dock); 
void makeDockVisible(KDockWidget *dock); 
void makeWidgetDockVisible(QW idget * widget); 

KDockManager *manager(); 

void readDockConfig(KConfig *c = OL, QString group = QString::null); 
void setMainDockWidget(KDockWidget *); 
void setCentralWidget(QWidget *); 

void writeDockConfig(KConfig *c = OL, QString group = QString: :null); 

다음의 실례는 그림 19-12 에 보여 주는 제 일 웃준위창문부품으로서 KDockMainWindow 를 
사용한다. 

/* showdockmainwindow.cpp */ 

#include <kapplication.h> 

#include <kdockwidget.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showdatetable”); 

KDockMainWindow * dockmainwindow = new KDockMainWindow(); 

dockmainwindow->setBackgroundColor(QColor( M blue M )); 

dockmainwindow->show(); 

app. setMainWidget(dockmainwindow); 

retum(app. exec()); 

> 



그림 19-12. 제 일 웃준위 창문으로서 사용하는 KDockMainWindow 
류동가능창문부품들을 추가하는 실례는 KDockWidget 를 보시오. 

KDockWidget 


KDockWidget 는 KDockMainWindow 창문부품안의 류동가능창문부품들중 하나의 창문부품 





을 보유하는 특수한 용기창문부품이다. 

머리 부파일 

#include <kdockwidget.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

구성자 

KDockWidget(KDockManager *dockManager, const char *name, const QPixmap &pixmap, 
QWidget *parent = OL); 

메쏘드 

KDockManager *dockManager(); 

int dockSite(); 

int enableDocking(); 

virtual bool event(QEvent *); 

QWidget *getWidget(); 
bool isDockBackPossible(); 
void makeDockVisible(); 

KDockWidget *manualDock(KDockWidget * target, DockPosition dockPos, int spliPos = 50, 
QPoint pos = QPoint ( 0) , bool check = false ); 
bool mayBeHide(); 
bool mayBeShow(); 
void setDockSite(int pos); 
void setEnableDocking(int pos); 
void setHeader(KDockWidgetAbstractHeader *ah); 
void setToolTipString(const QString &ttStr); 
void setWidget(QWidget *w); 
virtual void show(); 
const QString & toolTipString(); 

처리부 

void changeHideShowState(); 
void dockBack(); 
void undock(); 

신호 

void docking(KDockWidget *dw, KDockWidget::DockPosition dp); 
void headerCloseButtonClicked(); 
void headerDockbackButtonClicked(); 
void iMBeingClosed(); 
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void setDockDefaultPos(); 

렬거형 

enum DockPosition { DockNone=0, DockTop=0x0001, DockLeft=0x0002, DockRight=0x0004, 
DockBottom=0x0008, DockCenter=0x0010, DockDesktop=0x0020, 
DockComer=DockTop|DockLeft|DockRight|DockBottom, 

DockFullSite=DockComer|DockCenter, DockFullDocking=DockFullSite|DockDesktop }; 

다음의 실례는 3 개의 KDockWidget 창문부품을 사용하여 KDockMainWindow 에 3개 창문 
부품을 추가한다. 그림 19-13 에 보여주는것처럼 창문부품들은 조종판창문에 현시된다. 전체 
창문은 마우스에 의하여 구성될수 있다. 또한 창문크기를 늘이고 줄이는데 쓰이는 창문부품 
들사이의 띠들뿐아니라 매개 류동된 창문부품들의 출현을 허용 또는 금지하는데 쓰이는 조 
종띠(류동가능)가 있다. setMainDockWidget () 호출은 그 경계들을 따라 류동된 창문부품들에 
의해 로출된 공간에 나타나는 창문부품을 지정하며 이 실례에서 그것은 오른쪽웃구석의 구 
역이다. 

/* showdockwidget.cpp */ 

#include <kapplication.h> 

#include <kdockwidget.h> 
int main(int argc’char **argv) 

{ 

KApplication app(argc,argv, " showdatetable"); 

KDockMainWindow *dockmainwindow = new KDockMainWindow(); 

QPixmap pixmap( M idea.png M ); 

KDockWidget *mainDock = dockmainwindow->createDockWidget( M Main Dock M ,pixmap); 

QWidget *actualMain = new QWidget(mainDock); 
actualMain->setBackgroundColor(QColor(" green")); 
actualMain->setMinimumSize(200,200); 
dockmainwindow->setCentralWidget(mainDock); 
dockmainwindow->setMainDockWidget(mainDock); 

KDockWidget *leftDock = dockmainwindow->createDockWidget("Left Dock",pixmap); 

QWidget *actualLeft = new QWidget(leftDock); 
actualLeft->setBackgroundColor(QColor("blue")); 
actualLeft->setMinimnmSize(200,200); 

leftDock->manualDock(mainDock, KDockWidget::DockLeft,20); 

KDockWidget *bottomDock = dockmainwindow->createDockWidget( M Bottom Dock",pixmap); 

QWidget *actualBottom = new QWidget(bottomDock); 

actualBottom->setBackgroundColor(QColor( M red")); 

actualBottom->setMinimumSize(200,200); 
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bottomDock->manualDock(mainDock, KDockWidget: : DockBottom,20); 

dockmainwindow->activateDock(); 

app. setMainWidget(dockmainwindow); 

retnm(app.exec()); 



그림 19-13. KDockMainWindow 안의 3 개 창문부품을 류동하는데 사용한 KDockWidget 

KDoubleNumlnput 

KDoubleNumlnput 창문부품은 류점수들을 입력하고 사용자입력을 확인한다. 

머 러 부파일 

#include <knuminput.h> 

기초클라스 

KNumlnput QObject QPaintDevice QWidget Qt 

구성자 

KDoubleNumInput(double value, QWidget *parent = 0, const char *name = 0); 
KDoubleNumInput(KNumInput *below, double value, QWidget *parent = 0, const char *name = 0); 
메쏘드 

virtual QSize minimumSizeHint() const; 
void setFormat(const char *format); 

virtual void setLabel(QString label, int a = AlignLefl | AlignTop); 
void setRange(double lower, double upper, double step = 1, bool slider = true); 
void setSpecialValueText(const QString &text); 
double value() const; 

처리부 

void setPrefix(QString prefix); 
void setSuffix(QString suffix); 
void setValue(double); 
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신호 


void valueChanged(double); 

그림 1 9 -14 에 보여 준것 처 럼 입 력창문은 값을 선 택 하는데 쓰이 는 미 끄럼 띠 를 포함한다. 
걸음값을 지정하는데 미끄럼띠나 스핀단추를 리용할수 있다. 

/* showdoublenuminput.cpp */ 

#include <kapplication.h> 

#include <knuminput.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showdoublenuminput"); 

KDoubleNumlnput *doublenuminput = new KDoubleNumInput(980); 

doublenuminput->setRange(100.0,1000.0,10,true); 

doublenuminput->showO ； 

app. setMainW idget(doublenuminput); 

retum(app. exec()); 

} 



그림 19-14. 미끄럼띠를 가지는 KDoubleNumlnput 창문부품 

KDualColorButton 

KDualColorButton 창문부품은 매개가 각이 한 색을 가지 는 한쌍의 겹 침 단추들을 현시 하며 
사용자가 단추를 선택할 때 색선택대화칸이 열리게 함으로써 마우스에 응답한다. 

머리 부파일 

#include <kdualcolorbtn.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

구성 자 

KDualColorButton(QWidget *parent = 0， const char *name = 0); 

KDualColorButton(const QColor &fgColor, const QColor &bgColor, QWidget *parent = 0, 
const char *name = 0); 

메쏘드 

QColor background(); 

DualColor cnrrent(); 
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QColor currentColor(); 

QColor foregroundO ； 
virtual QSize sizeHint() const; 

처리부 

void slotSetBackground(const QColor &c); 
void slotSetCurrent(KDualColorButton::DualColor s); 
void slotSetCurrentColor(const QColor &c); 
void slotSetForegronnd(const QColor &c); 

신호 

void bgChanged(const QColor &c); 

void currentChanged(KDualColorButton: : DualColor s); 

void fgChanged(const QColor &c); 

렬거형 

enum DualColor { Foreground, Background }; 

다음의 실례는 그림 19-15 에서 그러진 2개의 색단추를 현시한다. 단추들중 하나를 두번 
찰칵하면 사용자가 색을 변경할수 있는 색대화칸창문을 펼친다. 

/* showdualcolorbutton.cpp */ 

#include <kapplication.h> 

#include <kdualcolorbtn.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showdualcolorbutton"); 

KDualColorButton *dualcolorbutton = new KDualColorButton(QColor( M red M ),QColor( M green M )); 

dualcolorbutton->show(); 

app. setMainWidget(dualcolorbutton); 

retnm(app.exec()); 

} 



그림 19-15. 2 가지 색중 하나의 선택을 허용하는 KDualColorButton 창문부품 
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KEdFind 


KEdFind 는 2 개의 파라메터에 의해 탐색하려는 문자렬을 받아들이는 대화칸이다. 
머리 부파일 

#include <keditcl.h> 

기초클라스 

KDialog KDialogBase QDialog QObject QPaintDevice QWidget Qt 

구성자 

KEdFind(QWidget *parent = 0， const char *name = 0， bool modal = true); 

메쏘드 

bool case_sensitive(); 

QString getText(); 

bool get_direction(); 

void setText(QString string); 

신호 

void doneO ； 
void search(); 

다음의 실례는 그림 19-16 에 보여주는 KEdFind 대화칸을 현시한다. 

/* showedfmd.cpp */ 

#include <kapplication.h> 

#include <keditcl.h> 

int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, ” showedfind”); 

KEdFind *edfmd = new KEdFind(); 
edfind->setText( M The search string”); 
edfind->show(); 
retum(app.exec()); 



Find ： 



[ 石 「Eind X Cancel 

그림 19-16. 문자렬람색을 하는데 필요한 정보를 요구하는 KEdFind 대화칸 

KEdGotoLine 

KEdGotoLine 창문부품은 행번호에 의해 본문을 탐색할수 있게 한다. 

머리 부파일 

#include <keditcl.h> 

기초클라스 

KDialog KDialogBase QDialog QObject QPaintDevice QWidget Qt 

구성 자 

KEdGotoLine(QWidget *parent = 0， const char *name = 0， bool modal = true); 

메쏘드 

int getLineNumberO ； 

처 리 부 

void selected(int); 

다음의 실례는 그림 19-17 에 보여 주는 KEdGotoLine 대화칸을 현시 한다. 

/* showedgotoline.cpp */ 

#include <kapplication.h> 

#include <keditcl.h> 

int main(int argc，char **argv) 

{ 

KApplication app(argc,argv, "showedgotoline"); 

KEdGotoLine *edgotoline = new KEdGotoLineO ； 

edgotoline->show(); 

retnm(app.exec()); 
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그림 19-17. 탐색본문의 행번호를 요구하는 KEdGotoLine 대화칸 

KEdit 

KEdit 창문부품은 간단한 문서 편집 기이 다. 

머 러 부파일 

#include <keditcl.h> 

기초클라스 

QFrame QMultiLineEdit QObject QPaintDevice QTableView QWidget Qt 

구성자 

KEdit(QWidget *_parent = NULL, const char *name = NULL); 

메쏘드 

void cleanWhiteSpace(); 
int currentColumn(); 

int currentLineO ； 
void doGotoLineO ； 
void insertText(QTextStream *); 
void installRBPopup(QPopupMenu *); 
bool isModified(); 

QString markedText(); 
bool repeatSearch(); 
void replaceO ； 

void saveText(QTextStream *); 
void searchO ； 
void selectFontO ； 
void setModified(bool = true); 
void spellcheck_start(); 
void spellcheck_stop(); 

처 리 부 

void computePositionO ； 

void corrected(QString originalword, QString newword, unsigned pos); 
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void misspelling(QString word, QStringList *, unsigned pos); 

void repaintA110 ； 

void replace_all_slotO ； 

void replace_search_slot(); 

void replace slotO ； 

void replacedone_slotO ； 

void search_slot(); 

void searchdone_slot(); 

신호 

void CursorPositionChangedO ； 
void gotUrlDrop(QDropEvent *e); 
void toggle_overwrite_signalO ； 

렬거형 

enum (anon) { NONE, FORWARD, BACKWARD }; 

다음의 실례는 그림 19-18 에 보여주는 편집창문을 현시한다. 

/* showedit.cpp */ 

#include <kapplication.h> 

#include <keditcl.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, 

KEdit *edit = new KEdit(); 
edit- 〉 show(); 
app. setMainWidget(edit); 
retum(app. exec()); 

} 


그림 19-18. 기본문서 편집기인 KEdit 창문부품 


” showedit，，); 



KApplication 

app(ai 해， argv, "showedit”) ; 
KEdit ♦edit = new KEditO ； 
edit->show ()； 
edit->setCaption(”edir); 
app.setMainWidget(edit )； 





KEdReplace 


KEdReplace 창문부품은 문서편집기의 람색 및 교체대화칸이다. 

머리 부파일 

#include <keditcl.h> 

기초클라스 

KDialog KDialogBase QDialog QObject QPaintDevice QWidget Qt 

구성자 

KEdReplace(QWidget *parent = 0， const char *name = 0， bool modal = true); 

메쏘드 

bool case_sensitive(); 

QString getReplaceText(); 

QString getText(); 
bool get_direction(); 
void setText(QString); 

신호 

void done(); 
void find(); 
void replace(); 
void replaceAll(); 

다음의 실례는 그림 19-19 에 보여 주는 KEdReplace 대화칸을 현시 한다. 

/* showedreplace.cpp */ 

#include <kapplication.h> 

#include <keditcl.h> 

int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showedreplace"); 

KEdReplace *edreplace = new KEdReplace(); 

edreplace->show(); 

retum(app.exec()); 



Find ： 

ii 

Replace with ： 

pOpOons - 

□ Case sensitive 


Replace All 

▼ 

- 1 ~ 1 Replace 

▼ 京 " Eind 

Findljackwaids x Cancel 


그림 19-19. 문자렬 의 람색 및 교체 를 위한 KEdReplace 대 화칸 


KFileDialog 

KFileDialog 창문부품은 파일들을 열람하고 선택하는데 사용되는 대화칸이다. 

머 러 부파일 

#include <kfiledialog.h> 

기초클라스 

KDialog KDialogBase QDialog QObject QPaintDevice QWidget Qt 

구성자 

KFileDialog(const QString &urlName, const QString &filter, QWidget *parent, const char *name, 
bool modal); 

메쏘드 

KURL baseURLO const; 

QString currentFilter() const; 

static QString getExistingDirectory(const QString &url = QString::null, QWidget *parent = 0, 
const QString &caption = QString: :null); 

static QString getOpenFileName(const QString &dir = QString::null, 
const QString &filter = QString::null, QWidget *parent = 0, 
const QString &caption = QString:mull); 

static QStringList getOpenFileNames(const QString &dir = QString::null, 
const QString &filter = QString::null, QWidget *parent = 0, 
const QString &caption = QString: mull); 

static KURL getOpenURL(const QString &url = QString: :null, const QString &filter = QString: :nuli, 
QWidget *parent = 0, const QString &caption = QString: :null); 

List getOpenURLs(const QString &url = QString: :null, const QString &filter = QString: :null, 
QWidget *parent = 0, const QString &caption = QString::null); 
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static QString getSaveFileName(const QString &dir = QString::null, 
const QString &filter = QString::null, QWidget *parent = 0 ， 
const QString &caption = QString::null); 

static KURL getSaveURL(const QString &url = QString: :null, const QString &filter = QString: :null, 
QWidget *parent = 0， const QString &caption = QString::null); 

Mode mode() const; 

QString selectedFile() const; 

QStringList selectedFiles() const; 

KURL selectedURL() const; 

List selectedURLs() const; 

void setFilter(const QString &filter); 

void setLocationLabel(const QString &text); 

void setMode(KFile: : Mode m); 

void setPreviewWidget(const QWidget *w); 

void setSelection(const QString &name); 

void setURL(const KURL &url, bool clearforward = true); 

virtual void show(); 

KToolBar *toolBar() const; 

신호 

void fileHighlighted(const QString &); 
void fileSelected(const QString &); 
void filterChanged(const QString &filter); 
void historyUpdate(bool, bool); 

다음의 실례는 그림 19-20 에 보여 주는 파일대화칸창문을 현시한다. 구성 자의 첫 인수는 
파일람색을 시작하는 등록부의 이름이다. 이 실례와 같이 NULL 등록부가 지정되면 파일이 
선택될 때까지 현재작업등록부가 사용되고 그다음부터 파일이 선택된 마지막 등록부가 기동 
시에 사용된다. 둘째 인수는 어느 파일들을 목록에 포함해야 하는가를 결정하는 려과기이다. 
등록부들은 항상 포함되지만 파일들은 그 이름이 현재 선택된 정규식려과기와 일치하면 포 
함된다. 

/* showfiledialog.cpp */ 

#include <kapplication.h> 

#include <kfiledialog.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, M showfiledialog"); 

QString filter("*.cpp|C++ Source Files\n” 
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、 h|C and C++ Header Files\n M 


，， *.awk\n” 

，， *. 이 Object files\n” 

”*|A11 Files”); 

KFileDialog *filedialog = new KFileDialog(0,filter, 0, "filedialog",FALSE); 
filedialog->showO ； 
retum(app. exec()); 



그림 19-20. 파일과 사용가능한 려과기들의 목록을 현시하는 KFileDialog 창문부품 

KFontChooser 

KFontChooser 는 사용자가 서체를 대화칸적으로 선택할수 있는 창문부품이다. 

머 러 부파일 

#include <kfontdialog.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

구성자 

KFontChooser(QWidget *parent = 0L, const char *name = 0L, bool onlyFixed = false, 
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const QStringList &fontList = QStringList 0 ， bool makeFrame = true , int visibleListSize = 8 ); 

메쏘드 

void enableColumn(int column, bool state); 

QFont font(); 

static void getFontList(QStringList &list, const char *pattem); 
static QString getXLFD(const QFont &theFont); 

QString sampleText(); 

void setFont(const QFont &font, bool onlyFixed = false); 
void setSampleText(const QString &text); 
virtual QSize sizeHint(void) const; 

신호 

void fontSelected(const QFont &font); 

렬거형 

enum FontColumn { FamilyList=0x01, StyleList=0x02, SizeList=0x04 }; 

5 장에 KFontChooser 를 사용하는 실례가 있다. 

KFontDialog 

KFontDialog 는 사용자가 서체를 선택할수 있는 대화칸이다. 

머리 부파일 

#include <kfontdialog.h> 

기 초클라스 

KDialog KDialogBase QDialog QObject QPaintDevice QWidget Qt 

구성 자 

KFontDialog(QWidget *parent = OL, const char *name = 0, bool modal = false, bool onlyFixed = fa 

const QStringList &fontlist = QStringList 0 > bool makeFrame = true ); 

메쏘드 

QFont font(); 

static int getFont(QFont &theFont, bool onlyFixed = false, QWidget *parent = 0L, 
bool makeFrame = true); 

static int getFontAndText(QFont &theFont, QString &theString, bool onlyFixed = false, 

QWidget *parent = 0L, bool makeFrame = true); 
void setFont(const QFont &font, bool onlyFixed = false); 

신호 


void fontSelected(const QFont &font); 




KFontDialog 을 사용하는 실례들은 10장에 있다. 


KFormulaEdit 

이 KFormulaEdit 창문부품은 공식을 현시하고 편집하는데 사용된다. 

머리 부파일 

#include <kformulaedit.h> 

기 초클라스 

QObject QPaintDevice QWidget Qt 

구성 자 

KFormulaEdit(QWidget *parent = 0, const char *name = 0, WFlags f = 0, bool restricted = false); 

메쏘드 

void enableSizeHintSignal(bool b); 

KFormula *getFormula() const; 
void redraw(int all = 1); 
void setExtraChars(QString c); 
void setText(QString text); 
void setUglyForm(QString ugly); 
virtual QSize sizeHint() const; 
virtual QSizePolicy sizePolicy() const; 

QString text() const; 

QString uglyForm() const; 

처리부 

void insertChar(int c); 

신호 

void formulaChanged(const QString &); 
void sizeHint(QSize); 

다음의 실례는 그림 19-21 에 보여주는 공식을 현시하는데 KFormulaEdit 창문부품을 사용 
한다. 공식 은 KFormula 의 fromUgly 메 쏘드에 의 해 C 형 표현 (“ ugly ” 형 식 )으로부터 형 식 화된다. 
공식 은 구성 자에 서 restricted 기 발을 TRUE 로 설 정 하면 평 가가능한 식 을 편 집 할수 있 다. 

/* showformulaedit. cpp */ 

#include <kapplication.h> 

#include <kformulaedit.h> 
int main(int argc’char **argv) 

I 

KApplication app(argc,argv, ’’showformulaedit’’); 




KFormulaEdit *formulaedit = new KFormulaEdit(0,0,0,TRUE); 

QString fii = KFormula::fromUgly( M 44.2 - k*(99.2 + 544) M )； 

formulaedit->setT ext(fii); 

formulaedit->showO ； 

app. setMainWidget(formulaedit); 

retum(app.exec()); 



그림 19-21. 공식을 현시하는 KFormulaEdit 창문부품 

KFormulaToolBar 

KFormulaToolBar 는 KFormulaEdit 창문부품에 특별한 형식화와 문자입력을 제공하는 도구 
띠 창문부품이 다. 

머리 부파일 

#include <kformulatoolbar.h> 

기초클라스 

KToolBar QFrame QObject QPaintDevice QWidget Qt 

구성 자 

KFormulaToolBar(QWidget *parent = 0L, const char *name = 0L, int item size = - 1); 

메쏘드 

void connectT oF ormula(KF ormulaEdit * formula); 

다음의 실례는 그림 19-22 에 보여 주는 KFormulaToolBar 를 현시한다. 

/* showformulatoolbar. cpp */ 

#include <kapplication.h> 

#include <kformulatoolbar.h> 
int main(int argc,char **argv) 
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KApplication app(argc,argv, "showformulatoolbar"); 

KFormulaToolBar *formulatoolbar = new KFormulaToolBarO ； 

formulatoolbar->showO ； 

app. setMainWidget(formulatoolbar); 

retum(app.exec()); 


} 



그림 19-22 . KFormulaToolbar 창문부품 

KGradientSelector 


KGradientSelector 창문부품은 2 가지 색 사이 의 경 사도를 현시한다. 그것은 마우스를 극값 
들사이의 색을 선택하는데 사용할수 있다. 

머리 부파일 

#include <kselect.h> 

기초클라스 

KSelector QObject QPaintDevice QRangeControl QWidget Qt 

구성자 

KGradientSelector(Orientation o, QWidget *parent = OL, const char *name = OL); 

메쏘드 

void setColors(const QColor &coll, const QColor &col2); 
void setText(const QString &tl, const QString &t2); 

다음의 실례는 그림 19-23 에 보여주는것처럼 붉은색과 흰색사이의 경사색들을 보여준다. 
2개 극값들사이 의 대 조를 보여주는 두개의 본문을 보여준다. 그림 의 바닥에 현재선택점 을 
표식하는 QRangeContr 이로부터 계승된 지시자가 있다. 

/* showgradientselector.cpp */ 

#include <kapplication.h> 

#include <kselect.h> 

int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showgradientselector"); 

KGradientSelector *gradientselector = new KGradientSelector(KSelector :: Horizontal); 
gradientselector->setColors(QColor( M red M ),QColor( M white M )); 





gradientselector- 〉 se 付 ext (” White on Red","Red on White"); 

gradientselector->show(); 

app. setMainWidget(gradientselector); 

retnm(app.exec()); 



그림 19-23. 색경사도와 본문을 둘다 표시하는 KGradientSelector 창문부품 

KHSSelector 

KHSSelector 창문부품은 사용자가 마우스로 색 또는 색의 농도를 선택할수 있게 한다. 

머리 부파일 

#include <kcolordlg.h> 

기초클라스 

KXYSelector QObject QPaintDevice QWidget Qt 

구성 자 

KHSSelector(QWidget *parent); 

다음의 실례는 그림 19-24 에 보여 주는 다색창문을 현시한다. 색선택은 마우스를 가지고 
KXYSelector 로부터 계승된 지시자를 적당한 장소에 놓음으로써 수행된다. 

/* showhsselector.cpp */ 

#include <kapplication.h> 

#include <kcolordlg.h> 
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int main(int argc，char **argv) 

{ 

KApplication app(argc,argv, " showhsselector"); 
KHSSelector *hsselector = new KHSSelector(0); 
hsselector->showO ； 
app.setMainWidget(hsselector); 
retum(app. exec()); 

} 



그림 19-24. 현재 선택한 색점을 표시하는 KHSSelector 창문부품 

KHTMLView 

KHTMLView 창문부품은 웨브폐지를 현시하는데 쓰인다. 

머 러 부파일 

#include <khtmlview.h> 

기초클라스 

QFrame QObject QPaintDevice QScrollView QWidget Qt 

구성자 

KHTMLView(KHTMLPart *part, QWidget *parent, const char *name = 0); 

메쏘드 

bool dndEnabledO const; 
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int frameWidth() const; 

bool gotoNextLink(); 

bool gotoPrevLink(); 

bool hasSelection() const; 

void layout(bool force = false); 

int marginHeight(); 

int marginWidth() const; 

KHTMLPart *part() const; 
void print(); 

QString selectedText() const; 

void setDNDEnabled(bool b); 

void setMarginHeight(int y); 

void setMarginWidth(int x); 

void setURLCursor(const QCursor &c); 

void toggleActLink(bool); 

const QCursor & urlCursor() const; 

static const QList<KHTMLView> *viewList(); 

신호 

void selectionChanged(); 

다음의 실례는 그림 19-25 에 보여주는 웨브폐지를 현시하는데 KHTMLView 객체를 사용 
한다. 그것은 URL 을 보관하는 KURL 객체를 만들어서 수행한다. 이 실례에서 URL 은 국부디 
스크에 있으나 인터네트상의 임의의곳일수 있다. KURL 객체는 실제 웨브폐지를 열 때 
KHTMLPart 객체 에 의 해서 사용된다. 독자적 인 구성자를 사용하지 않고 이미 폐지를 현시하 
도록 설정된 KHTMLView 객체를 돌려주려고 할 때 KHTMLPart 객체의 view () 메쏘드가 호출된 
다. KHTMLView 의 크기가 설정되고 창문부품이 현시될 때 폐지 그 자체가 현시된다. 

/* showhtmlview.cpp */ 

#include <kapplication.h> 

#include <iostream.h> 

#include <kurl.h> 

#include <khtml_part.h> 

#include <khtmlview.h> 
int main(int argc’char **argv) 

{ 

KApplication app(argc,argv, ” showhtmlview”); 

KURL kurl = M file:/home/testpage.htmr'; 

KHTMLPart *part = new KHTMLPart(); 
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if( !part->openURL(kurl)) 


cout « "The URL failed to open” « endl; 
KHTMLView *htmlview = part->view(); 
htmlview->resize(400,200); 
htmlview->showO ； 
app. setMainW idget(htmlview); 
retum(app. exec()); 



그림 19-25. KHTMLPart 객체로부터 웨브폐지 를 현시하는 KHTMLView 창문부품 

KIconButton 

KIconButton 은 KIconDialog 창문을 펼친 다음 선택된 그림기호를 현시하는 단추창문부품 
머 러 부파일 

#include <kicondialog.h> 

기초클라스 

QButton QObject QPaintDevice QPushButton QWidget Qt 

구성자 

KIconButton(QWidget *parent = OL, const char *name = OL); 

KIconButton(KIconLoader * loader, QWidget *parent, const char *name = OL); 

메쏘드 

const QString iconO ； 
void setIcon(QString icon); 

void setIconType(int group, int context, bool user = false); 


신호 









void iconChanged(QString icon); 

다음 실례는 그림 기호를 포함한 KIconButton 을 현시한다. 이 실례는 그림 19-26 과 같이 
setIcon() 을 호출함으로써 시 작그림 기 호를 지 정한다. 그림 기호가 지 정되 지 않았으면 단추는 
처음에 비 여있고 KIconDialog 로부터 그림기호가 선택될 때까지 그대로 남아있다. 

/* showiconbutton.cpp */ 

#include <kapplication.h> 

#include <kicondialog.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, " showiconbutton"); 

KIconButton *iconbutton = new KIconButtonO ； 
iconbutton->setIcon( M go"); 
iconbutton->showO ； 
app. setMainWidget(iconbutton); 
retum(app. exec()); 

} 

! 하 . I 

그림 19-26. 현재 선택된 그림기호를 현시하는 KIconButton 

KIconDialog 

KIconDialog 창문부품은 그림기호를 선택하는데 쓰이는 대화칸이다. 

머리 부파일 

#include <kicondialog.h> 

기초클라스 

KDialog KDialogBase QDialog QObject QPaintDevice QWidget Qt 

구성 자 

KIconDialog(QWidget *parent = OL, const char *name = OL); 

KIconDialog(KIconLoader * loader, QWidget *parent = 0, const char *name = 0); 

메쏘드 

QString selectIcon(int group = KIcon::Desktop, int context = KIcon::Application, bool user = false); 

다음 실례는 KIconDialog 창문을 현시한다. 그림 19-27 은 체계응용프로그람의 그림기호들 
을 현시하고있다. 







/* showicondialog.cpp */ 

#include <kapplication.h> 

#include <kicondialog.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc ， argv, "showicondialog”); 
KIconDialog *icondialog = new KIconDialogO ； 
icondialog->show(); 
retum(app. exec()); 

} 



그림 19-27. 체 계 응용프로그람 그림 기 호들을 현시 하는 KIconDialog 

KlconView 

KIconView 창문부품은 사용자가 선 택 할수 있는 그림 기 호들의 모임 을 현시한다. 이 창문 
부품은 마우스단추조종과 선택에 표준 KDE 환경을 사용하도록 QlconView 를 확장한다. 

머리 부파일 
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기초클라스 


QFrame QlconView QObject QPaintDevice QScrollView QWidget Qt 

파생 클라스 

KFilelconView KlconCanvas 

구성자 

KIconView(QWidget *parent = 0， const char *name = 0， WFlags f = 0); 

신호 

void doubleClicked(QIconViewItem *item, const QPoint &pos); 

void executed(QIconViewItem *item); 

void executed(QIconViewItem *item, const QPoint &pos); 

다음 실례는 그림 19-28 에 보여 주는 5개 그림기 호를 현시한다. 첫째 그림 기호는 픽 스매 
프도 본문도 가지지 않으므로 기 정픽스매프를 사용하여 표식을 얻는다. 다음 두 그림기호도 
역시 기정적스매프를 사용하지만 둘다 표식에 본문을 가지고있다. 마지막 2개 그림기호는 
픽 스매프와 표식 을 모두 가지 며 “ Flag ” 로 표시 된 그림 기 호가 마우스에 의해 선택되 였다. 

/* showiconview.cpp */ 

#include <kapplication.h> 

#include <kiconview.h> 
int main(int argc’char **argv) 

{. 

QlconViewItem *item; 

KApplication app(argc,argv ， ”showiconview”); 

KIconView *iconview = new KIconView(); 

item = new QlconViewItem(iconview); 

item = new QIconViewItem(iconview, "Icon Label”); 

item = new QIconViewItem(iconview, ’’Icon With\nLong Label"); 

QPixmap flag( M flag.png M ); 

item = new QIconViewItem(iconview, "Flag",flag); 

QPixmap idea( M idea.png M ); 

item = new QIconViewItem(iconview, "Idea",idea); 

iconview->show(); 

app. setMainWidget(iconview); 

retum(app. exec()); 

} 
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그림 19-28. 5개 그림 기 호를 현시 하는 KIconView 창문부품 

KlmageTrackLabel 

KImageTrackLabel 창문부품은 QLabel 을 확장하여 마우스동작을 추적하고 조종능력을 추 
가한다. 

머리 부파일 

#include <kaboutdialog.h> 

기초클라스 

QFrame QLabel QObject QPaintDevice QWidget Qt 

구성 자 

KImageTrackLabel(QWidget *parent, const char *name = 0， WFlags f = 0); 

신호 

void mouseTrack(int mode，const QMouseEvent *e); 

렬거형 

enum MouseMode { MousePress=l, MouseRelease, MouseDoubleClick, MouseMove }; 

다음 실례는 그림 19-29 에 보여주는 간단한 본문창문부품으로서 KImageTrackLabel 창문 
부품을 현시한다. 처리부가 mouseTrackO 에 련결되였다면 모든 마우스작용이 통보된다. 

/* showimagetracklabel.cpp */ 

#include <kapplication.h> 

#include <kaboutdialog.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, ” showimagetracklabel”); 

KImageTrackLabel *imagetracklabel = new KImageTrackLabel(0); 
imagetracklabel->setText("Mouse Tracking Label"); 
imagetracklabel->show(); 
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app. setMainWidget(imagetracklabel); 
retnm(app.exec()); 

} 

- -wBS • □ x 

Mouse Tracking Label 

그림 19-29. 마우스를 추적하는 표식자로써 KImageTrackLabel 

KlntNumlnput 

KIntNumInput 창문부품은 사용자의 옹근수값입 력 을 받아들이 고 확인하기 위 한것 이 다. 

머리 부파일 

#include <knuminput.h> 

기초클라스 

KNumlnput QObject QPaintDevice QWidget Qt 

구성 자 

KIntNumInput(int value, QWidget *parent = 0 ， int base = 10, const char *name = 0); 
KIntNnmInput(KNumInput *below, int value, QWidget *parent = 0, int base = 10, 
const char *name = 0); 

메쏘드 

virtual QSize minimumSizeHint() const; 

virtual void setLabel(QString label, int a = AlignLeft | AlignTop); 
void setRange(int lower, int upper, int step = 1, bool slider = true); 
void setSpecialValueText(const QString &text); 
int valueO const; 

처 리 부 

void setEditFocus(bool mark = true); 
void setPrefix(QString prefix); 
void setSuffix(QString suffix); 
void setValue(int); 

신호 

void valueChanged(int); 

그림 19-30 과 같이 입 력창문은 미 끄럼 띠 또는 스핀단추에 의 하여 기 동할수 있고 둘다 
값을 선택하는데 사용된다. 또한 값은 자료창문에 직접 입력된다. 

/* showintnuminput.cpp */ 

#include <kapplication.h> 
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#include <knuminput.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showintnuminput"); 

KlntNumlnput *intnuminput = new KIntNumInput(980); 

intnuminput->setRange(1 00, 1000,10,true); 

intnuminput->showO ； 

app. setMainW idget(intnuminput); 

retum(app. exec()); 



그림 19-30. 스핀단추와 미끄럼띠를 모두 가진 KlntNumlnput 창문부품 

KlntSpinBox 

KIntSpinBox 창문부품은 사용자의 옹근수값입력을 받아들이고 확인하기 위한것이다. 

머리 부파일 

#include <knuminput.h> 

기초클라스 

QFrame QObject QPaintDevice QRangeControl QSpinBox QWidget Qt 

구성자 

KIntSpinBox(int lower, int upper, int step, int value, int base = 10， QWidget *parent = 0, 
const char *name = 0); 

메쏘드 

void setEditFocus(bool mark); 

다음 실례는 그림 19-31 에 보여주는 KlntSpinBox 를 만든다. 값은 스핀칸을 사용하여 걸 
음값씩 수를 변 경 하거 나 자료창문에 직 접 값을 입 력 하여 설 정한다. 

/* showintspinbox.cpp */ 

#include <kapplication.h> 

#include <knuminput.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, " showintspinbox"); 

KlntSpinBox *intspinbox = new KIntSpinBox(100,1000,10,980); 
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intspinbox->show(); 

app. setMainWidget(intspinbox); 

retum(app. exec()); 


그림 19-31. 스핀단추를 가지는 KIntSpinBox 창문부품 

KKeyButton 

KKeyButton 창문부품은 건반단추와 같이 보이는 QButton 이다. 

머러부파일 

#include <kkeydialog.h> 

기초클라스 

QButton QObject QPaintDevice QPushButton QWidget Qt 

구성자 

KKeyButton(const char *name = 0， QWidget *parent = 0); 

메쏘드 

void setEdit(bool edit); 

void setText(const QString &text); 

다음 실 례 프로그람은 제 일 웃준위창문부품으로서 KKeyButton 창문부품을 사용하며 그림 
19-32 에서 보여준다. 

/* showkeybutton, cpp */ 

#include <kapplication.h> 

#include <kkeydialog.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showkeybutton"); 

KKeyButton *keybutton = new KKeyButtonO ； 

keybutton->setText("Key Button"); 

keybutton->showO ； 

app. setMainW idget(keybutton); 

retum(app. exec()); 

} 


583 




그림 19-32. 건반단추모양의 KKeyButton 창문부품 

KLed 

KLed 창문부품은 각이한 모양과 색의 지시자로 쓰이는 LED 를 현시한다. 

머 러 부파일 

#include <kled.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

구성자 

KLed(const QColor &col = Qt::green, QWidget *parent = 0, const char *name = 0); 

KLed(const QColor &col, KLed::State st, KLed::Look look, KLed::Shape shape, QWidget *parent = 0 ， 
const char *name = 0); 

메쏘드 

const QColor color() const; 
int getDarkFactor() const; 

Look lookO const; 

void setColor(const QColor &color); 

void setDarkFactor(int darkfactor); 

void setLook(Look look); 

void setShape(Shape s); 

void setState(State state); 

State stateO const; 
void toggleState(); 

처 리 부 

void o 伴 (); 
void on(); 
void toggleO ； 

렬거형 

enum State { Off, On, NoOfStates }; 

enum Shape { NoShape, Rectangular, Circular, NoOfShapes=Circular }; 
enum Look { NoLook, Flat, Raised, Sunken, NoOfLooks=Sunken }; 

KLed 실례를 그림 19-33 에 보여준다. 그것은 도드라져 나온 원형지시자인데 기정색 즉 록 
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색으로 색칠된다. 


/* showled.cpp */ 

#include <kapplication.h> 

#include <kled.h> 

int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showled"); 

KLed *led = new KLed(); 

led->setLook(KLed: : Raised); 

led->setShape(KLed: : Circular); 

led->setState(KLed: :On); 

led- 〉 resize(10,10); 

led->showO ； 

app. setMainWidget(led); 

retum(app. exec()); 



그림 19-33. 도드라져 나온 둥근 KLed 창문부품 

KLineEdit 

KLineEdit 창문부품은 단일 행 본문편 집 기 이 다. 

머리 부파일 

#include <klineedit.h> 

기초클라스 

KCompletionBase QLineEdit QObject QPaintDevice QWidget Qt 

파생 클라스 

KRestrictedLine 

구성 자 

KLineEdit(const QString &string, QWidget *parent, const char *name = 0); 
KLineEdit(QWidget *parent = 0, const char *name = 0); 

메쏘드 


void cursorAtEnd(); 
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bool isContextMenuEnabledO const; 

virtual void setCompletionMode(KGlobalSettings :: Completion mode); 
virtual void setEnableContextMenu(bool showMenu); 

처리부 

void rotateText(KeyBindingType); 

신호 

void completion(const QString &); 
void nextMatch(KeyBindingType); 
void previousMatch(KeyBindingType); 
void retumPressed(const QString &); 

다음 실례는 그림 19-34 에서 보여 주는 KLineEdit 창문을 창조하고 현시한다. KLineEdit 창 
문부품은 QLineEdit 창문부품에 기초한다. KLineE 此에 추가된 특성으로서 선택적인 본문보완 
과 환경구성가능한 건결합이 있다. 

#include <kapplication.h> 

#include <klineedit.h> 

int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, ” showlineedit”); 

KLineEdit *lineedit = new KLineEdit(); 

lineedit->show(); 

app. setMainWidget(lineedit); 

retum(app.exec()); 

} 



그림 19-34. QLineEdit 을 계 승한 KLineEdit 창문부품 
QLineEdit 창문부품의 실례는 4 장에 있다. 

KLineEditDIg 

KLineEditDlg 는 단일행본문을 편집하기 위한 QLineEdit 창문부품을 담고있는 대화칸이다. 
머 러 부파일 

#include <klineeditdlg.h> 

기초클라스 

KDialog KDialogBase QDialog QObject QPaintDevice QWidget Qt 
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구성 자 


KLineEditDlg(const QString &_text, const QString &_value, QWidget *parent); 

메쏘드 

static QString getText(const QString &_text, const QString &_value, bool *ok, QWidget *parent); 
QString textO ； 

처리부 

void slotClear(); 

다음 실례는 그림 19-35 와 같이 제목문자렬과 기정본문을 가진 KLineEditDlg 창문을 현 
시한다. 

/* showlineeditdlg.cpp */ 

#include <kapplication.h> 

#include <klineeditdlg.h> 
int main(int argc,char **argv) 

{ 

bool OK; 

QString str; 

KApplication app(argc,argv, "showlineeditdlg"); 

str = KLineEditDlg :: getText("The caption", "The editable text", &OK, 0); 
if(OK) { 

// The OK button was selected 
} else { 

// The CANCEL button was selected 

} 

retnm(app.exec()); 



그림 19-35. QLineEdit 창문부품을 가진 KLineEditDlg 대 화칸 
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KListBox 


KListBox 창문부품은 사용자가 마우스로 선 택 할수 있는 항목목록을 현시한다. 이 창문부 
품은 QListBox 를 확장하여 마우스단추조종과 선택을 위한 표준 KDE 환경 을 사용하게 한다. 
머리 부파일 

#include <klistbox.h> 

기 초클라스 

QFrame QListBox QObject QPaintDevice QScrollView QWidget Qt 
파생 클라스 
KSplitList 
구성 자 

KListBox(QWidget *parent = 0， const char *name = 0， WFlags f = 0); 

신호 

void doubleClicked(QListBoxItem *item, const QPoint &pos); 

void executed(QListBoxItem *item); 

void executed(QListBoxItem *item, const QPoint &pos); 

다음의 실례는 그림 19-36 에 보여주는 KListBox 창문을 현시한다. 

/* showlistbox.cpp */ 

#include <kapplication.h> 

#include <klistbox.h> 

int main(int argc’char **argv) 

{ 

KApplication app(argc,argv, ” showlistbox”); 

KListBox *listbox = new KListBox(); 
for(int i=0; i<20; i++) { 

QString str; 

str.sprintf (” Selection %d\n’’ ， i); 
listbox->insertItem(str); 

} 

listbox->setMinimumWidth( 120); 
listbox- 〉 show(); 
app. setMainWidget(listbox); 
retum(app. exec()); 
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그림 19-36. 현재 선택한 항목을 현시하는 KListBox 창문부품 


KListView 

KListView 창문부품은 사용자가 마우스로 열람할수 있는 목록을 나무형식으로 현시한다. 
이 창문부품은 QListView 를 확장하여 마우스단추조작과 선택에 표준 KDE 환경을 사용하게 한 
다. 

머리 부파일 

#include <klistview.h> 

기초클라스 

QFrame QListView QObject QPaintDevice QScrollView QWidget Qt 

파생 클라스 

KApplicationTree KFileDetailView 

구성자 

KListView(QWidget *parent = 0， const char *name = 0); 

메쏘드 

virtual bool isExecuteArea(const QPoint &point); 

신호 

void doubleClicked(QListViewltem *item, const QPoint &pos, int c); 
void executed(QListViewItem *item); 

void executed(QListViewItem *item, const QPoint &pos, int c) 

이 클라스는 QListView 의 간단한 확장이며 거의 류사하게 동작한다. 

18장에 QListView 를 사용한 실례가 있다. 

KMainWindow 

KMainWindow 창문부품은 표준 KDE 의 제 일 웃준위창문이 다. 
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머리 부파일 


#include <kmainwindow.h> 

기 초클라스 

KXMLGUIBuilder KXMLGUIClient QObject QPaintDevice QWidget Qt 

파생 클라스 

KDockMainW indow 

구성 자 

KMainWindow(const char *name = OL, WFlags f = WDestructiveClose); 

메쏘드 

int addToolBar(KToolBar *toolbar, int index = - 1); 

static bool canBeRestored(int number); 

static const QString classNameOfToplevel(int number); 

virtual void createGUI(const QString &xmlfile = QString: :null); 

void enableStatusBar(KStatusBar::BarStatus stat = KStatusBar::Toggle); 

void enableToolBar(KToolBar: : BarStatus stat = KToolBar: : Toggle, int id = 0); 

virtual KXMLGUIFactory *guiFactory(); 

bool hasMenuBar(); 

bool hasStatusBar(); 

bool hasToolBar(int ID = 0); 

QPopupMenu *helpMenu(const QString &aboutAppText = QString::null, bool showWhatsThis = true); 
QWidget *indicator(); 

QRect mainViewGeometry() const; 

KMenuBar *menuBar(); 
bool restore(int number); 

void setEnableToolBar(KToolBar::BarStatus stat = KToolBar:: Toggle, const QString &name = mainToo 

IBar); 

void setFrameBorderWidth(int); 

void setIndicatorWidget(QWidget *indicator); 

void setMaximumToolBarWraps(unsigned int wraps); 

void setMenu(KMenuBar *menuBar); 

void setStatusBar(KStatusBar *statusBar); 

void setCentralWidget(QWidget *view, bool show frame = TRUE); 
virtual void show(); 

QSize sizeHint() const; 

KStatusBar *statusBar(); 

KToolBar *toolBar(int ID = 0); 
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KToolBar *toolBar(const QString &name); 
QWidget *view() const; 


처 리 부 

void appHelpActivated(void); 

virtual void setCaption(const QString &caption); 

virtual void setPlainCaption(const QString &caption); 

6 장에 KMainWindow 창문부품의 실례가 있다. 

KMenuBar 

KMenuBar 는 튀 여나오기 차림 표들의 그룹사이 의 관계 를 관리 할수 있는 수평 띠 이다. 이 
창문부품은 QMenuBar 를 확장하여 마우스단추조종과 선택에 표준 KDE 환경을 사용하게 한다. 
머리 부파일 

#include <kmenubar.h> 

기초클라스 

QFrame QMenuBar QMenuData QObject QPaintDevice Q Widget Qt 

구성자 

KMenuBar(QWidget *parent = 0, const char *name = 0); 

다음 실례는 2 장의 튀 여 나오기 차림 표를 포함하는 KMenuBar 를 현시 한다. 매개 튀 여 나오 
기 차림 표는 단일차림 표항목을 담고 있다. 그림 19-37 은 두번째 튀 여나오기 차림 표를 가진 차 
림표띠를 보여준다. 

/* showmenubar.cpp */ 

#include <kapplication.h> 

#include <kmenubar.h> 

#include <kpopupmenu.h> 
int main(int argc’char **argv) 

{ 

KApplication app(argc,argv, M showmenubar"); 

KMenuBar *menubar = new KMenuBar(); 
menubar->setSeparator(KMenuBar: :InW indowsStyle); 

KPopupMenu* filePopup = new KPopupMenu(); 
filePopup->insertItem("&Quit",&app,SLOT(quit())); 
menubar->insertItem("&File",filePopup); 

KPopupMenu* editPopup = new KPopupMenu(); 
editPopup->insertItem("&Paste"); 
menubar->insertItem( M E&dit M ,editPopup); 
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menubar->show(); 

app. setMainW idget(menubar); 

retum(app. exec()); 


그림 19-37. 튀 여나오기 차림 표를 보여 주는 KMenuBar 

KNumlnput 

KNumlnput 창문부품은 수입력 창문부품을 실현하는데 쓰이는 기초클라스이다. 
머 러 부파일 

#include <knuminput.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

파생 클라스 

KDoubleNumlnput KlntNumlnput 

구성자 

KNnmInput(QWidget *parent = 0， const char *name = 0); 

KNumInput(KNumInput *below, QWidget *parent = 0， const char *name = 0); 

메쏘드 

virtual void setLabel(QString label, int a = AlignLefl | AlignTop); 
void setSteps(int minor, int major); 
virtual QSize sizeHint() const; 

QSizePolicy sizePolicyQ const; 


KPaletteTable 

KPaletteTable 창문부품은 사용자가 색을 선택할수 있게 한다. 
머 러 부파일 

#include <kcolordlg.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

구성자 

KPaletteTable(QWidget *parent, int minWidth = 210, int cols = 16); 
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메쏘드 

void addToCustomColors(const QColor &); 
void addToRecentColors(const QColor &); 

QString paletteO ； 

처 리 부 

void setPalette(const QString &paletteName); 

신호 

void colorSelected(const QColor &， const QString &); 

다음 실례는 KPaletteTable 창문부품을 현시한다. 그림 19-38 과 같이 색을 선택하는 방법 
은 많다. 그림의 왼쪽에서 KPaletteTable 창문부품은 직4각형의 색항목들을 현시하며 오른쪽에 
있는 KPaletteTable 창문부품은 이 름에 의해 색 목록을 현시 한다. 

/* showpalettetable.cpp */ 

#include <kapplication.h> 

#include <kcolordlg.h> 

int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, " showpalettetable"); 

KPaletteTable *palettetable = new KPaletteTable(O); 
palettetable->showO ； 
app. setMainWidget(palettetable); 
retum(app. exec()); 

} 



그림 19-38. 두가지 색선택방법을 보여주는 2개의 KPaletteTable 창문부품 

KPanelApplet 

KPanelApplet 는 KDE 애플레트를 창조하는데 쓰이는 기초클라스이다. 

머리 부파일 
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#include <kpanelapplet.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

구성자 

KPanelApplet(QWidget *parent = 0， const char *name = 0); 

메쏘드 

virtual void about(); 
int actions(); 
bool flags(); 

virtual int heightForWidth(int width); 

virtual void help(); 

void init(int &argc, char **argv); 

Orientation orientation() const; 

Position positionQ const; 
virtual void preferences(); 

bool process(const QCString &fun, const QByteArray &data, QCString &replyType, 
QByteArray &replyData); 
virtual void removedFromPanel(); 
void setActions(int a); 
void setFlags(int f); 
void updateLayout(); 
virtual int widthForHeight(int height); 

렬거형 

enum Actions { About=l, Help=2, Preferences=4 }; 

enum Flags { Stretch=l, TopLevel=2 }; 

enum Position { Left=0, Right, Top, Bottom }; 

15 장에서 애플레트를 창조하는데 KPanelApplet 클라스를 사용하는 실례가 있다. 

KPasswordDialog 

KPasswordDialog 창문부품은 암호의 입력과 새로운 암호의 확인에 쓰인다. 

머리 부파일 

#include <kpassdlg.h> 

기 초클라스 

KDialog KDialogBase QDialog QObject QPaintDevice QWidget Qt 

구성 자 
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KPasswordDialog(int type, QString prompt, bool enableKeep = false, int extraBttn = 0); 

메쏘드 

void addLine(QString key, QString value); 
static void disableCoreDumps(); 

static int getNewPassword(QCString &password, QString prompt); 

static int getPassword(QCString &password, QString prompt, int *keep = 0L); 

bool keep() const; 

const char *password() const; 

void setPrompt(QString prompt); 

렬거형 

enum Types { Password, NewPassword }; 

다음 실례는 사용자로부터 암호를 요구하는데 KPasswordDialog 창문부품을 사용하는 방법을 
보여준다. 그림 19-39 와 같이 입력한 문자렬은 별표들의 렬로 나타난다. 메쏘드 getNewPasswordO 를 
getPasswordO 대신에 사용한다면 암호는 두번 입력 하여 확인해야 한다. 

/* showpassworddialog.cpp */ 

#include <kapplication.h> 

#include <kpassdlg.h> 

int main(int argc,char **argv) 

{ 

int code; 

QCString password; 

QString prompt = ” Enter your password”; 

KApplication app(argc,argv, " showpassworddialog"); 
code = KPasswordDialog::getPassword(password,prompt); 
if(code = QDialog: : Accepted) { 

// A password was entered 
} else if(code = QDialog::Rejected) { 

// A password was not entered 

} 

retum(app.exec()); 

} 
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Enter your password 


% 

Password ： | 幸幸幸 ♦ 幸♦♦參 | 

\x OK ; K Cancel 

그림 19-39. 암호를 모르게 입 력하는 KPasswordDialog 창문부품 

KPasswordEdit 

KPasswordEdit 창문부품은 암호로 사용할수 있도록 본문을 모르게 입력하는 단일행편집 
기 이 다. 

머리 부파일 

#include <kpassdlg.h> 

기초클라스 

QLineEdit QObject QPaintDevice QWidget Qt 

구성 자 

KPasswordEdit(QWidget *parent = 0， const char *name = 0); 

메쏘드 

void eraseO ； 

const char *password0 ； 

렬거형 

enum EchoModes { OneStar, ThreeStars, NoEcho }; 

다음 실례는 그림 19-40 에 보여주는 KPasswordEdit 창문부품을 현시한다. 

/* showpasswordedit. cpp */ 

#include <kapplication.h> 

#include <kpassdlg.h> 

int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showpasswordedit"); 

KPasswordEdit *passwordedit = new KPasswordEditO ； 

passwordedit->showO ； 

app. setMainWidget(passwordedit); 
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retum(app. exec()); 


> 



그림 19-40. 본문을 모르게 입 력하는 KPasswordEdit 창문부품 


KPopupMenu 

KPopupMenu 창문부품은 KMenuBar 그리고 다른 KPopupMenu 객체들과 결합하여 KDE 표 
준차림표폼을 만드는데 사용된다. 이 창문부품은 QPopupMenu 를 확장하여 마우스단추조종과 
선택에 표준 KDE 환경을 사용하게 한다. 

머리 부파일 

#include <kpopmenu.h> 

기초클라스 


QFrame QMenuData QObject QPaintDevice QPopupMenu QWidget Qt 

구성자 

KPopupMenu(QWidget *parent = 0， const char *name = 0); 

KPopupMenu(const QString &title, QWidget *parent = 0, const char *name = 0); 

메쏘드 


void changeTitle(int id, const QString &text); 

void changeTitle(int id, const QPixmap &icon, const QString &text); 
int insertTitle(const QString &text, int id = - 1, int index = - 1); 

int insertTitle(const QPixmap &icon, const QString &text, int id = - 1, int index = - 1); 
void setTitle(const QString &title); 

QString title(int id = - 1); 

QPixmap titlePixmap(int id); 

KMenuBar 를 가진 KPopupMenu 를 사용하는 실례는 이 장의 KMenuBar 에 있다. 6 장에 
QPopupMenu 를 사용하는 실례가 있다. 


KProgress 

KProgress 창문부품은 수평 또는 수직으로 향하는 진척상황띠이다. 
머리 부파일 

#include <kprogress.h> 

기초클라스 

QFrame QObject QPaintDevice QRangeControl QWidget Qt 
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구성자 

KProgress(QWidget *parent = 0， const char *name = 0); 

KProgress(Orientation, QWidget *parent = 0， const char *name = 0); 

KProgress(int minValue, int maxValue, int value, Orientation, QWidget *parent = 0 ， 
const char *name = 0); 

메쏘드 

const QColor & barColor() const; 
const QPixmap *barPixmap() const; 

BarStyle barStyle() const; 

QString format() const; 

Orientation orientation() const; 
void setBarColor(const QColor &); 
void setBarPixmap(const QPixmap &); 
void setBarStyle(BarStyle style); 
void setFormat(const QString &format); 
void setOrientation(Orientation); 
void setTextEnabled(bool); 
virtual QSize sizeHint() const; 
virtual QSizePolicy sizePolicy() const; 
bool textEnabled() const; 

처 리 부 

void advance(int prog); 
void setValue(int); 

신호 

void percentageChanged(int); 

렬거형 

enum Orientation { Horizontal, Vertical }; 
enum BarStyle { Solid, Blocked }; 

다음 실례는 그림 19-41 에 보여 주는 수평 KProgress 창문부품을 현시한다. 진척상황띠 의 
모양과 형식을 바꾸는데 사용할수 있는 메쏘드는 많다. 

/* showprogress.cpp */ 

#include <kapplication.h> 

#include <kprogress.h> 

int main(int argc’char **argv) 

{ 

KApplication app(argc,argv, "showprogress"); 
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KProgress *progress = new KProgress(0,500,350, KProgress :: Horizontal); 

progress->showO ； 

app. setMainWidget(progress); 

retnm(app.exec()); 



그림 19-41. 진행률을 보여주는 KProgress 창문부품 

KRestrictedLine 

KRestrictedLine 창문부품은 입력으로서 한행의 본문을 받아들이고 입력을 지정된 문자들 
의 모임으로 제한한다. 

머리 부파일 

#include <krestrictedline.h> 

기초클라스 

KCompletionBase KLineEdit QLineEdit QObject QPaintDevice QWidget Qt 

구성자 

KRestrictedLine(QWidget *parent = 0, const char *name = 0, const QString &valid = QString::null); 

메쏘드 

void setValidChars(const QString & valid); 

신호 

void invalidChar(int); 

다음 실례 는 그림 19-42 에 보여 주는 KRes 仕 ictedLine 창문부품을 현시한다. setYalidChars () 
호출은 대소문자모음과 대문자 Y 로 입력을 제한한다. 어떠한 다른 문자도 받아들이지 않고 
invalidChar () 신호를 발생시킨다. 

/* showrestrictedline.cpp */ 

#include <kapplication.h> 

#include <krestrictedline.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showrestrictedline"); 

KRestrictedLine *restrictedline = new KRestrictedLineO ； 
restrictedline->setValidChars(” aeiouAEIOUY”); 
restrictedline->showO ； 


599 



app. setMainWidget(restrictedline); 
retnm(app.exec()); 



그림 19-42. 허용된 문자들만 보여주는 KRes 仕 icedLine 창문부품 

KRootPermsIcon 

KRootPermissions 창문부품은 현재사용자가 root 허가를 가지는가를 가리 키는 그림 기호를 
현 시 한다. 

머리 부파일 

#include <kauthicon.h> 

기초클라스 

KAuthlcon QObject QPaintDevice QWidget Qt 

구성 자 

KRootPermsIcon(QWidget *parent = 0， const char *name = 0); 

메쏘드 

bool status() const; 

처 리 부 

void updateStatusO ； 

다음 실 례 는 제 일 웃준위 창문으로서 KRootPermsIcon 창문부품을 사용하며 사용자가 root 
허가를 가지는가 못가지는가에 따라 그림 19-43 에서 보여주는 두 그림기호중의 하나를 현시 
한다. 

/* showrootpermsicon.cpp */ 

#include <kapplication.h> 

#include <kauthicon.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showrootpermsicon"); 

KRootPermsIcon *rootpermsicon = new KRootPermsIconO ； 

rootpermsicon->show(); 

app. setMainWidget(rootpermsicon); 

retum(app. exec()); 




그림 19-43. KRootPermsIcon 창문부품현시의 2가지 형식 

KRuler 

KRuler 창문부품은 눈금자처 럼 표식 이 불은 수직 혹은 수평 창문을 현시 한다. 

머리 부파일 

#include <kruler.h> 

기초클라스 

QFrame QObject QPaintDevice QWidget Qt 

구성 자 

KRuler(KRuler: :direction dir, QWidget *parent = 0， const char *name = 0， WFlags f = 0 ， 
bool allowLines = TRUE); 

KRuler(KRuler: :direction dir, int widgetWidth, QWidget *parent = 0， const char *name = 0, 
WFlags f = 0, bool allowLines = TRUE); 

메쏘드 

inline int getBigMarkDistance() const; 

int getEndOffsetO const; 

int getLength() const; 

bool getLengthFixO const; 

inline int getLittleMarkDistance() const; 

inline int getMaxValueO const; 

inline int getMediumMarkDistanceO const; 

metric style getMetricRulerStyle() const; 

inline int getMinValue() const; 

inline int getOffsetO const; 

paint style getPaintRulerStyle() const; 

inline double getPixelPerMark() const; 

bool getShowBigMarks() const; 

bool getShowEndMarksO const; 

bool getShowLittleMarks() const; 

bool getShowMediumMarksO const; 

bool getShowPointer() const; 
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bool getShowTinyMarks() const; 

paint style getTickStyleO const; 

inline int getTinyMarkDistance() const; 

inline int getValue() const; 

void setBigMarkDistance(int); 

void setEndLabel(const QString &); 

void setLength(int); 

void setLengthFix(bool fix); 

void setLittleMarkDistance(int); 

void setMaxValue(int); 

void setMediumMarkDistance(int); 

void setMinValue(int); 

void setOffset(int offset); 

void setPixelPerMark(double); 

void setRange(int min, int max); 

void setRulerStyle(KRuler: : metric_style); 

void setRulerStyle(KRuler: : paint style); 

void setTickStyle(KRuler: : paint_style); 

void setTinyMarkDistance(int); 

void setValue(int); 

void setValuePerBigMark(int); 

void setValuePerLittleMark(int); 

void setValuePerMediumMark(int); 

void showBigMarkLabel(bool); 

void showBigMarks(bool); 

void showEndLabel(bool); 

void showEndMarks(bool); 

void showLittleMarkLabel(bool); 

void showLittleMarks(bool); 

void showMediumMarkLabel(bool); 

void showMediumMarks(bool); 

void showPointer(bool); 

void showTinyMarks(bool); 

void slidedown(int count =1); 

void slideup(int count =1); 
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처 리 부 


void slotEndOffset(int) ; 
void slotNewOffset(int); 
void slotNewValue(int); 

렬거형 

enum direction { horizontal, vertical }; 

enum metric_style { custom=0, pixel, inch, millimetres, centimetres, metres }; 
enum paint style { flat, raised, sunken }; 

다음 실례프로그람은 그림 19-44 에 보여주는 KRuler 를 현시한다. 

/* showruler.cpp */ 

#include <kapplication.h> 

#include <1 江 uler.h 〉 

int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showruler"); 

KRuler * ruler = new KRuler(KRuler: : horizontal); 

ruler->setRulerStyle(KRuler::pixel); 

ruler->setLength(l 000); 

ruler->setValue(750); 

ruler->showBigMarks(TRUE); 

ruler->showT inyMarks(FALSE); 

mler->showMediumMarks(FALSE); 

ruler->showLittleMarks(FALSE); 

ruler->showEndMarks(F ALSE); 

ruler->showEndLabel(FALSE); 

ruler->showO ； 

app. setMainW idget(ruler); 


retnm(app.exec()); 

} 



그림 19-44. 간단한 KRuler 
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KSelector 


KSelector 창문부품은 창문안의 수평 혹은 수직위치를 선택하는 창문부품을 창조하는데 
쓰이는 기초클라스이다. 

머리 부파일 

#include <kselect.h> 

기 초클라스 

QObject QPaintDevice QRangeControl QWidget Qt 

파생 클라스 

KGradientSelector KValueSelector 

구성 자 

KSelector(Orientation o, QWidget *parent = OL, const char *name = OL); 

메쏘드 

QRect contentsRect(); 
bool indent() const; 

Orientation orientation() const; 
void setIndent(bool i); 

신호 

void valueChanged(int value); 

렬거형 

enum Orientation { Horizontal, Vertical }; 

다음 실례는 그림 19-45 와 같이 수평 KSelector 창문부품을 현시한다. 창문바닥의 경계선 
에 있는 지시기는 마우스에 의해 이동할수 있으며 valueChangedO 신호를 발생한다. 

/* showselector.cpp */ 

#include <kapplication.h> 

#include <kselect.h> 

int main(int argc’char **argv) 

{ 

KApplication app(argc,argv, "showselector"); 

KSelector * selector = new KSelector(KSelector::Horizontal); 

selector->show(); 

app. setMainWidget(selector); 

retum(app. exec()); 



그림 19-45. 바닥에 선택지시기를 보여주는 수평 KSelector 창문부품 

KSeparator 

KSeparator 창문부품은 표준 KDE 구분기창문부품이다. 론리 그룹을 만들 때 차림표와 다른 
창문에서 사용된다. 

머리 부파일 

#include <kseparator.h> 

기초클라스 

QFrame QObject QPaintDevice QWidget Qt 

구성 자 

KSeparator(QWidget *parent = 0， const char *name = 0， WFlags f = 0); 

KSeparator(int orientation, QWidget *parent = 0, const char *name = 0, WFlags f = 0); 

메쏘드 

int orientation() const; 
void setOrientation(int); 
virtual QSize sizeHint() const; 

다음 실폐 는 그림 19-46 에 보여 주는 수평 KSeparator 창문부품을 현시한다. 

/* showseparator.cpp */ 

#include <kapplication.h> 

#include <kseparator.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showseparator"); 

KSeparator * separator = new KSeparator(Qt: : Horizontal); 

separator->show(); 

app. setMainW idget(separator); 

retum(app.exec()); 

} 



그림 19-46. 수평 KSeparator 창문부품 

KSpellConfig 

KSpellConfig 창문부품은 철자검사대화칸을 현시한다. 

머리 부파일 

#include <ksconfig.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

구성 자 

KSpellConfig(QWidget *parent = 0, const char *name = 0, KSpellConfig *spellConfig = 0, 
bool addHelpButton = true); 

KSpellConfig(const KSpellConfig &); 

메쏘드 

int clientO const; 
bool dictFromList() const; 
const QString dictionaryO const; 
int encoding() const; 

QStringList ignoreListQ const; 

bool noRootAffix() const; 

bool runTogetherO const; 

void setClient(int client); 

void setDictFromList(bool dfl); 

void setDictionary(const QString qs); 

void setEncoding(int enctype); 

void setIgnoreList(QStringList ignorelist); 

void setNoRootAffix(bool); 

void setRunTogether(bool); 

bool writeGlobalSettingsO ； 

처 리 부 
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void activateHelp(void); 

다음 실례는 제일 웃준위창문으로서 그림 19-47 에 보여주는 KSpellConfig 창문을 현시한 

/* showspellconfig.cpp */ 

#include <kapplication.h> 

#include <ksconfig.h> 

int main(int argc，char **argv) 

{ 

KApplication app(argc,argv, ” showspellconfig”); 

KSpellConfig *spellconfig = new KSpellConfig(); 

spellconfig->show(); 

app. setMainWidget(spellconfig); 

retum(app. exec()); 

} 



그림 19-47. KSpellConfig 창문부품 

KSpellDIg 

KSpellDlg 창문부품은 철자가 틀린 단어들과 수정안들의 목록을 현시하고 그 처리방법을 
지정하는 단추들에 응답한다. 

머리 부파일 

#include <kspelldlg.h> 

기초클라스 

QObject QPaintDevice QWidget Qt 

구성 자 

KSpellDlg(QWidget *parent, const char *name, bool _progressbar = FALSE, bool modal = FALSE); 

메쏘드 







void init(const QString &_word, QStringList *_sugg); 
inline QString replacement(); 
void standby(); 

처리부 

void slotProgress(unsigned int p); 

신호 

void command(int); 

KSpeUDlg 의 다음 실례는 그림 19-48 과 같이 철자가 틀린 단어들과 수정안들의 목록으 
로 현시를 초기화한다. init () 메 쏘드는 자료를 삽입하고 모든 단추들을 가능케 하며 standby () 
메 쏘드는 단추들을 금지한다. 

/* showspelldlg.cpp */ 

#include <kapplication.h> 

#include <kspelldlg.h> 

int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, "showspelldlg"); 

QString word = "tehn"; 

QStringList * suggestion = new QStringList(); 
suggestion->append("the M ); 
suggestion->append("then"); 
suggestion->append( M ten M ); 

KSpellDlg *spelldlg = new KSpellDlg(0, ” spelldlg”); 

spelldlg->init(word,suggestion); 

spelldlg->show(); 

app. setMainW idget(spelldlg); 

retum(app.exec()); 

} 
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spelldlg 



그림 19-48. KSpellDlg 창문부품 

KStatusBar 

KStatusBar 창문부품은 KMainWindow 의 현시부분에 포함된다. 본문, 도형과 같은 상태를 
현시 하거 나 사용자정 의창문부품으로 사용된 다. 

머리 부파일 

#include <kstatusbar.h> 

기초클라스 

QObject QPaintDevice QStatusBar QWidget Qt 

구성자 

KStatusBar(QWidget *parent = OL, const char *name = OL); 

메쏘드 

void changeItem(const QString &text, int id); 

inline void insertFixedttem(const QString &text, int ID, bool permanent = false); 

void insertItem(const QString &text, int ID, int stretch = 0, bool permanent = false); 

void removeItem(int id); 

void setItemAlignment(int id, int align); 

void setltemFixed(int id, int width = - 1); 


신호 
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void pressed(int); 
void released(int); 

렬거형 

enum BarStatus { Toggle, Show, Hide }; 

6 장에 KSt 加 isBar 를 사용하는 실례가 있다. 

KStatusBarLabel 

KStatusBarLabel 은 KStatusBar 창문부품내에서 사용되며 마우스에 의 해 조종되는 특별 한 
표식자이다. 

머리 부파일 

#include <kstatusbar.h> 

기초클라스 

QFrame QLabel QObject QPaintDevice QWidget Qt 

구성자 

KStatusBarLabel(const QString &text, int _id, KStatusBar *parent = OL, const char *name = OL); 

신호 

void itemPressed(int id); 
void itemReleased(int id); 

다음 실례는 그림 19-49 에서 보여 주는 KStatusBarLabel 창문부품을 창조하고 현시한다. 
구성자는 표식자본문뿐아니라 신호와 함께 제공되는 식별번호도 가전다. 

/* showstatusbarlabel .cpp */ 

#include <kapplication.h> 

#include <kstatusbar.h> 
int main(int argc,char **argv) 

{ 

KApplication app(argc,argv, ” showstatusbarlabel”); 

KStatusBarLabel *statusbarlabel = new KStatusBarLabel( M Label text”,4); 

statusbarlabel->show(); 

app. setMainWidget(statusbarlabel); 

retnm(app.exec()); 

} 



그림 19-49. KStatusBarLabel 창문부품 
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KTextBrowser 


KTextBrowser 창문부품은 URL 과 전자우편련결을 인식하고 응답하도록 추가기능을 가지 
는 본문열람기이다. 

머리 부파일 

#include <ktextbrowser.h> 

기 초클라스 

QFrame QObject QPaintDevice QScrollView QTextBrowser QTextView QWidget Qt 

구성 자 

KTextBrowser(QWidget *parent = 0， const char *name = 0， bool notifyClick = false); 

메쏘드 

void setNotifyClick(bool notifyClick); 

신호 

void mailClick(const QString &name, const QString &address); 
void urlClick(const QString &url); 

다음 실례는 그림 19-5 0 에 보여주는 본문을 현시한다. URL 과 전자우편응답은 
setNotifyClick () 를 호출하여 능동으로 혹은 해제될수 있다. 

/* showtextbrowser.cpp */ 

#include <kapplication.h> 

#include <ktextbrowser.h> 
char text[] = 

"This is the text being displayed\n” 

’’by the text browser. Both vertical\n" 

” and horizontal scroll bars will\n M 
"appear as necessary. 
int main(int argc’char **argv) 

{ 

KApplication app(argc ， argv ， "showtextbrowser"); 

KTextBrowser *textbrowser = new KTextBrowser(); 
textbrowser->show(); 
textbrowser->setText(QString(text)); 
app. setMainWidget(textbrowser); 
retum(app. exec()); 



This is the text being displayed 
by the text browser. Both vertical 
and horizontal scroll bars will 
appear as necessaiy. 


그림 19-50. 본문을 현시하는 KTextBrowswer 창문부품 

KToolBar 

KToolBar 창문부품은 몇가지 종류의 도구창문부품들을 포함할수 있고 여러 위치에서 
고다닐수 있는 도구띠이다. 

머리 부파일 

#include <ktoolbar.h> 

기초클라스 

QFrame QObject QPaintDevice QWidget Qt 

파생 클라스 

KF ormulaT oolBar 

구성자 

KToolBar(QWidget *parent = 0L, const char *name = 0L, bool honor mode = false); 

메쏘드 

void addConnection(int id, const char * signal, const QObject *receiver, const char *slot); 
void alignItemRight(int id, bool right = true); 

KAnimWidget *animatedWidget(int id); 

BarPosition barPosO const; 

void changeComboItem(int id, const QString &text, int index = - 1); 
void clearO ； 

void clearCombo(int id); 

bool contextMemiEnabled() const; 

int countO ； 

bool enable(BarStatus stat); 
void enableFloating(bool arrrrrrgh); 
void enableMoving(bool flag = true); 
bool fullSize() const; 






KToolBarButton *getButton(int id); 

QComboBox *getCombo(int id); 

QString getComboItem(int id, int index = - 1); 

KLineEdit *getLined(int id); 

QString getLinedText(int id); 

QWidget *getWidget(int id); 

virtual int heightForWidth(int width) const; 

void hideltem(int id); 

int iconSize() const; 

IconText iconText() const; 

int insertAnimatedWidget(int id, QObject *receiver, const char *slot, const QStringList &icons, 
int index = - 1); 

int insertButton(const QString &icon, int id, bool enabled = true, const QString &text = QString: :null, 
int index = - 1); 

int insertButton(const QString &icon, int id, const char * signal, const QObject *receiver, 
const char *slot, bool enabled = true, const QString &text = QString: :null, int index = - 1); 
int insertButton(const QPixmap &pixmap, int id, bool enabled = true, 
const QString &text = QString::null, int index = - 1); 
int insertButton(const QPixmap &pixmap, int id, const char * signal, const QObject *receiver, 
const char *slot, bool enabled = true, const QString &text = QString: :nnll, int index = - 1); 
int insertButton(const QPixmap &pixmap, int id, QPopupMenu *popup, bool enabled, 
const QString &_text, int index = - 1); 

int insertCombo(QStrList *list, int id, bool writable, const char * signal, const QObject *receiver, 
const char *slot, bool enabled = true, const QString &t ⑴ ltiptext = QString: :null, int size = 70, 
int index = - 1, QComboBox: : Policy policy = QComboBox: : AtBottom); 
int insertCombo(const QStringList &list, int id, bool writable, const char * signal, 
const QObject *receiver, const char *slot, bool enabled = true, 
const QString &tooltiptext = QString: :null, int size = 70, int index = - 1, 

QComboBox::Policy policy = QComboBox::AtBottom); 
int insertCombo(const QString &text, int id, bool writable, 

const char * signal, QObject *recevier, const char *slot, bool enabled = true, 
const QString &tooltiptext = QString::null, int size = 70, int index = - 1, 

QComboBox::Policy policy = QComboBox::AtBottom); 
void insertComboItem(int id, const QString &text, int index); 
void insertComboList(int id, QStrList *list, int index); 
void insertComboList(int id, const QStringList &list, int index); 

613 








int insertLineSeparator(int index = - 1); 

int insertLined(const QString &text, int ID, const char * signal, const QObject *receiver, 

const char *slot, bool enabled = true, const QString &toolTipText = QString: :null, int size = 70, 
int index = - 1); 

int insertSeparator(int index = - 1); 

int insertWidget(int id, int width, QWidget *_widget, int index = - 1); 
bool isButtonOn(int id); 
int maxHeight(); 
int maxWidth(); 

virtual QSize maximumSizeHint() const; 
virtual QSize minimumSizeHint() const; 
void removeComboItem(int id, int index); 
void removeItem(int id); 
void saveState(); 

void setAutoRepeat(int id, bool flag = true); 

void setBarPos(BarPosition bpos); 

void setButton(int id, bool flag); 

void setButtonIcon(int id, const QString &_icon); 

void setButtonPixmap(int id, const QPixmap &_pixmap); 

void setCurrentComboItem(int id, int index); 

void setDelayedPopup(int id, QPopupMenu *_popup, bool toggle = false); 

void setEnableContextMenu(bool enable = true); 

void setFlat(bool flag); 

void setFullSize(bool flag = true); 

void setIconSize(int size); 

void setIconSize(int size, bool update); 

void setlconText(IconText it); 

void setlconText(IconText it, bool update); 

void setItemAutoSized(int id, bool yes = true); 

void setItemEnabled(int id, bool enabled); 

void setItemNoStyle(int id, bool no style = true); 

void setLinedText(int id, const QString &text); 

void setMaxHeight(int h); 

void setMaxWidth(int dw); 

void setTitle(const QString &_title); 

void setToggle(int id, bool flag = true); 
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void setXML(const QString &xmlfile, const QDomDocument &xml); 

void showItem(int id); 

virtual QSize sizeHint() const; 

virtual QSizePolicy sizePolicyO const; 

void toggleButton(int id); 

void updateRects(bool resize = false); 

virtual int widthForHeight(int height) const; 

신호 

void clicked(int id); 

void doubleClicked(int id); 

void highlighted(int id, bool isHighlighted); 

void highlighted(int id); 

void modechange(); 

void moved(BarPosition); 

void pressed(int); 

void released(int); 

void toggled(int); 

렬거형 

enum IconText { IconOnly=0, IconTextRight, TextOnly, IconTextBottom }; 
enum BarStatus { Toggle, Show, Hide }; 

enum BarPosition { Top=0, Left, Right, Bottom, Floating, Flat }; 

6 장에 KToolBar 창문부품의 실례가 있다. 

KToolBarButton 

KToolBarButton 창문부품은 마우스사건에 응답하는 단추들을 현시하기 위하여 KToolBar 
창문부품에 의 해 내 부적 으로 사용된다. KToolBarButton 은 KToolBar 의 insertButton () 메 쏘드들중 
하나를 호출하여 만든다. 식별번호를 사용한 KToolBar 메쏘드 getButton () 호출은 단추의 지적 
자를 얻어서 목록에 있는 메쏘드들을 사용가능하게 한다. 

머리 부파일 

#include <ktoolbarbutton.h> 

기 초클라스 

QButton QObject QPaintDevice QWidget Qt 

구성 자 

KToolBarButton(const QString &icon, int id, QWidget *parent, const char *name = OL, 
const QString &txt = QString: :null); 
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KToolBarButton(const QPixmap &pixmap, int id, QWidget *parent, const char *name = OL, 


const QString &txt = QString::null); 

KToolBarButton(QWidget *parent = OL, const char *name = OL); 

메쏘드 

void on(bool flag = true); 

QPopupMenu *popup(); 

virtual void setDefaultIcon(const QString &icon); 

virtual void setDefaultPixmap(const QPixmap &pixmap); 

void setDelayedPopup(QPopupMenu *p, bool toggle = false); 

virtual void setDisabledIcon(const QString &icon); 

virtual void setDisabledPixmap(const QPixmap &pixmap); 

void setEnabled(bool enable = true); 

virtual void setIcon(const QString &icon); 

virtual void setIcon(const QString &icon, bool generate); 

void setNoStyle(bool no_style = true); 

virtual void setPixmap(const QPixmap &pixmap); 

virtual void setPixmap(const QPixmap &pixmap, bool generate); 

void setPopup(QPopupMenu *p); 

void setRadio(bool f = true); 

virtual void setText(const QString &text); 

void setToggle(bool toggle = true); 

void toggle。; 

처 리 부 

void modeChange(); 

신호 

void clicked(int); 

void doubleClicked(int); 

void highlighted(int, bool); 

void pressed(int); 

void released(int); 

void toggled(int); 

6 장의 KToolBar 에 KToolBarButton 창문부품들을 만드는 실례들이 있다. 

KWizard 


KWizard 창문부품은 단계에 따라서 사용자를 차림표하는 대화칸을 만드는데 쓰인다. 매 




개 단계 는 한개 창문으로 이 루어 진 다. KWizard 창문부품은 폐 지작성 도구와 조종단추들을 제 
공한다. 이 창문부품은 QWizard 를 확장하여 대화칸에 표준 KDE 메쏘드모임을 포함하게 한다. 
그것은 KDialogBase 를 구축하는 기초클라스이다. 

머리 부파일 

#include <kwizard.h> 

기초클라스 

QDialog QObject QPaintDevice QWidget QWizard Qt 

구성자 

KWizard(QWidget *parent = 0, const char *name = 0, bool modal = false, WFlags f = 0); 

다음 실례 는 그림 19-51 에 보여 주는 빈 KWizard 창문부품을 현시한다. 

/* showwizard.cpp */ 

#include <kapplication.h> 

#include <kwizard.h> 

int main(int argc,char **argv) 

{ 

QApplication app(argc,argv); 

KWizard * wizard = new KWizardO ； 

wizard->showO ； 

app. setMainWidget(wizard); 

retnm(app.exec()); 

} 



그림 19-51. KWizard 창문부품 

KXYSelector 

KXYSelector 창문부품은 QWidget 대신에 쓰이는 기초클라스이고 마우스로 표면우의 점을 
선택하는 기능을 추가한다. 

머리 부파일 











기 초클라스 


QObject QPaintDevice QWidget Qt 

파생 클라스 

KHSSelector 

구성 자 

KXYSelector(QWidget *parent = OL, const char *name = OL); 

메쏘드 

QRect contentsRect(); 

void setRange(int _minX, int minY, int _maxX, int maxY); 
void setValues(int xPos, int yPos); 
int xValue(); 
int yValueO ； 

신호 

void valueChanged(int _x, int _y); 

KXZWidget 의 다음 실례는 그림 19-52 에 보여주는 +위치지시 기를 현시한다. 
/* showxyselector.cpp */ 

#include <kapplication.h> 

#include <kselect.h> 

int main(int argc’char **argv) 

{ 

QApplication app(argc,argv); 

KXYSelector *xyselector = new KXYSelector(); 
xyselector->show(); 
app. setMainWidget(xyselector); 
retum(app. exec()); 

} 
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그림 19-52. +위 치 지 시 기 를 가지 는 KXYSelector 창문부품 

요 약 

이 장은 매개 KDE 창문부품들의 자모순목록을 제공하였다. 매개 창문부품은 다음과 같 
은 형식으로 구성되였다. 

• 창문부품의 실례들을 만드는데 쓰이는 구성자들 

• 창문부품이 정의되는.머리부파일의 이름 

• 창문부품이 기능을 계승하는 모든 기초클라스들 

• 창문부품이 기능을 넘겨주는 모든 파생클라스들 

• 1개 창문부품의 사건을 다른 창문부품의 메쏘드호출에 련결하는데 사용되는 처리부와 
신호들 

• 응용프로그람에 사용할수 있는 공개메쏘드 

이 장과 앞장은 KDE 환경에서 실행하는 프로그람의 실례를 많이 포함하였다. 이 프로그 
탐과 다른 체계용으로 쓴 프로그람들사이에 차이가 많고 류사점도 많다. 다음 장은 간단한 
KDE 프로그람과 Windows 용으로 작성 한 같은 프로그람의 기본구조를 하나씩 비교한다. 
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제 20 장. 창문프로그람의 비교분석 

학습내용 

창문에 바른4각형들을 그리는 간단한 Win 32 프로그람의 작성 
창문에 바른4각형들을 그리는 간단한 KDE 프로그람의 작성 
창문에 바른4각형들을 그리는 간단한 GNOME 프로그람의 작성 
KDE 와 Win 32 프로그람의 비교 

이 미 Win 32 API 를 사용한 프로그람작성 에 익 숙되 여 있으면 이 장은 KDE / Qt 응용프로그 
탐의 구조를 리해 하는데 도움이 될 것 이 다. 가장 낮은 준위 에 서 두 프로그람작성 모형 은 매 우 
류사하다. 그것들은 모두 사건들이 들어오기를 기다리는 기본순환고리를 리용하여 조작하며 
사건이 도달할 때 함수는 응용프로그람에 통지하기 위하여 호출된다. 

될수록 간단히 비교하기 위하여 이 장은 Win 32 와 KDE 모두를 위한 간단한 프로그람을 실현 
한다. 


제 1 절. Win32 프로그람 

다음의 실례는 중심 이 같은 직4각형 들로 창문을 가득 채우는 Windows 프로그람이 다. 창 
문크기가 변할 때마다 직4각형들도 그것에 맞게 크기가 달라진다. 결과창문은 그림 20-1 과 
갈다. 

BoxBox 

1 /* boxbox.c (Win32) */ 

2 #include < windows . h > 

3 

4 #define STEP 3 

5 

6 static char name [] = “ BoxBox ” ; 

7 static int xBoxl ; 

8 static int yBoxl ; 

9 static int xBox 2; 

10 static int yBox 2; 

11 

12 LRESULT CALLBACK callback ( HWND , UINT , WPARAM , LPARAM ); 

13 

14 int WINAPI WinMain(HINSTANCE instance , 

15 HINSTANCE prev,PSTR commandLine,mt showCommand ) 

16 { 
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17 HWND window ; 

18 MSG message ; 

19 WNDCLASSEX winclass ; 

20 

21 winclass.cbSize = sizeof ( winclass ); 

22 winclass.style = CS_HREDRAW | CS _ VREDRAW ; 

23 winclass.lpfiiWndProc = callback ; 

24 winclass.cbClsExtra = 0; 

25 winclass.cbWndExtra = 0; 

26 winclass.hlnstance = instance ; 

27 winclass.hlcon = LoadIcon ( NULL , IDI _ APPLICATION ); 

28 winclass.hCursor = LoadCursor ( NULL , IDC _ ARROW ); 

29 winclass .IpszMenuN ame = NULL ; 

30 winclass.lpszClassName = name ; 

31 winclass.hlconSm = LoadIcon ( NULL , IDI 一 APPLICATION ); 

32 winclass.hbrBackground = 

33 ( HBRUSH ) GetStockObject ( WHITE _ BRUSH ); 

34 

3 5 RegisterClassEx (& winclass ); 

36 window = CreateWindow ( name ,” Boxes in Boxes ” , 

37 WS _ OVERLAPPEDWINDOW , 

38 CW _ USEDEFAULT , CW 一 USEDEFAULT , 

39 CW _ USEDEFAULT , CW _ USEDEFAULT , 

40 NULL , NULL , instance , NULL ); 

41 ShowWindow ( window , showCommand ); 

42 UpdateWindow ( window ); 

43 

44 while ( GetMessage (& message , NULL ,0,0)) { 

45 TranslateMessage (& message ); 

46 DispatchMessage (& message ); 

47 } 

48 retum ( message . wParam ); 

49} 

50 

51 LRESULT CALLBACK callback(HWND window,UINT messageType , 









52 

53 

54 

55 

56 

57 

58 

59 

60 
61 
62 

63 

64 

65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 


WPARAM wParam,LPARAM IParam ) 

int xl ; 
int yl ; 
int x 2; 
int y 2; 

HDC hdc ; 

PAINTSTRUCT ps ; 

switch ( messageType ) { 
case WM _ SIZE : 
xBoxl = 10; 
yBoxl = 10; 

xBox 2 = LOWORD ( lParam ) - 10; 
yBox 2 = HIWORD ( lParam ) - 10; 
retum ( O ); 
case WM _ PAINT : 

hdc = BeginPaint ( window ,& ps ); 
SetViewportOrgEx ( hdc ,0,0, NULL ); 
xl = xBoxl ; 
x 2 = xBox 2; 
yl = yBoxl ; 
y 2 = yBox 2; 

while((xl < x 2) && (yl < yl )) { 
MoveToEx ( hdc , xl , yl , NULL ); 



86 


EndPaint ( window ,& ps ); 
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87 retum ( O ); 

88 case WM _ DESTROY : 

89 PostQuitMessage ( O ); 

90 return (0); 

91 } 

92 retum ( DefWindowProc ( window , messageType , 

93 wParam , lParam )); 

94} 



프로그람은 2 개 함수만 가지고있다. 14행에서 시작하는 함수 WinMain () 은 프로그람을 
시 작하기 위 하여 조작체 계 에 의해 호출되 는 함수이다. 51행의 함수 callbackO 는 사건 이 일 어 
날 때 마다 조작체 계 에 의해 호출된 다. 

제2절. KDE 프로그람 

다음 실례는 중심 이 같은 직4각형 들로 창문을 가득 채우는 KDE 프로그람이다. 창문크기 
가 변할 때마다 직4각형들도 그것에 맞게 크기가 달라진다. 창문은 그림 20-2 와 갈다. 실례 
는 2개의 파일 즉 BoxBox 창문부품을 선언하는 머리부파일과 프로그람의 기본함수와 
BoxBox 클라스의 메쏘드들의 본체들을 포함하는 C ++ 원천파일로 되 여있다. 

BoxBox 머리 부파일 

1 /* boxbox.h ( KDE ) */ 

2 # ifndefBOXBOX_H 

3 #defme BOXBOX_H 

4 


5 #include < qwidget . h > 

6 

7 class BoxBox : public QWidget 

































8 { 

9 public: 

10 BoxBox(QWidget *parent=0,const char *name=0); 

11 private: 

12 intxBoxl; 

13 int yBoxl; 

14 int xBox2; 

15 int yBox2; 

16 protected: 

17 virtual void paintEvent(QPaintEvent *); 

18 virtual void resizeEvent(QResizeEvent *); 

19}; 

20 

21 #endif 
BoxBox 

1 /* boxbox.cpp (KDE) */ 

2 #include <kapplication.h> 

3 #include <qpainter.h> 

4 #include “boxbox.h” 

5 

6 #defme STEP 3 

7 

8 int main(int argc’char **argv) 

9{ 

10 KApplication app(argc,argv,” boxbox” ); 

11 BoxBox boxbox; 

12 boxbox.show(); 

13 app.setMainWidget(&boxbox); 

14 retum(app. exec()); 

15} 

16 BoxBox: : BoxBox(QWidget ^parent,const 

17 char *name) : QWidget(parent,name) 

18 { 

19 resize(400,200); 

20 } 
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21 void BoxBox: : paintEvent(QPaintEvent *) 

22 { 

23 QPainter p; 

24 

25 intxl =xBoxl; 

26 intyl =yBoxl; 

27 int x2 = xBox2; 

28 int y2 = yBox2; 

29 

30 p.begin(this); 

31 while((xl < x2) && (yl < y2)) { 

32 p.moveTo(xl,yl); 

33 p.lineTo(x2,yl); 

34 p.lineTo(x2,y2); 

35 p.lineTo(xl,y2); 

36 p.lineTo(xl,yl); 

37 xl += STEP; 

38 yl += STEP; 

39 x2 -= STEP; 

40 y2 -= STEP; 

41 } 

42 p.end(); 

43} 

44 void BoxBox: : resizeEvent(QResizeEvent *e) 

45 { 

46 QSize size = e->size(); 

47 xBoxl = 10; 

48 yBoxl = 10; 

49 xBox2 = size.width() - 10; 

50 yBox2 = size.height() - 10; 



그림 20-2. KDE 최 상위 창문 

이 프로그람은 KDE 환경을 초기화하고 창문부품을 만들어 현시하며 최상위창문으로 창 
문부품을 설 정한다. 그리 고 실 행 순환고리 에 들어 가는데 쓰이 는 main () 함수를 가지 고있다. 구 
성 자외 에 특정한 사건 이 발생할 때 실행되는 2개의 메쏘드가 있다. 

제 3 절 . Win32 와 KDE 의 대 비 

이 절은 KDE 와 Win 32 프로그람들사이의 류사성과 차이점을 자세히 설명한다. 

1. 초기화 

KDE 프로그람의 10행은 KApplication 객체를 구축한다. 또한 기초하는 도형방식쏘프트웨 
어의 GUI 대면부와 그밖의 부분들을 초기화한다. Win 32 API 가 조작체계의 부분이고 이미 초 
기화되기때문에 Win 32 에는 이 함수에 대응하는 부분이 없다. 그러나 KDE 는 조작체계의 부 
분이 아니 므로 창문쏘프트웨어 를 초기 화하여 야 한다. 

KApplication 객체의 구성은 그 이름을 프로그람에 할당하며 이것은 기정적으로 창문의 
제 일 우에 나타나는 제목으로 사용된다. Win 32 판에서 같은 동작은 36행의 CreateWindowO 호 
출이다. 

2. 기본장문 

KDE 프로그람의 11행은 BoxBox 객체를 만드는데 그것은 응용프로그람의 최상위창문으 
로 된다 . Win 32 판의 21〜33 행은 기본창문을 정의 하며 35 행의 RegisterClassEx () 호출은 그것을 
조작체계 에 등록한다. Win 32 최상위창문을 창조할 때 KDE 보다 더 많은 환경설정 이 요구된 
다. 이것은 Win 32 에서는 미리 모든 환경설정이 구체적으로 지정되여야 하고 KDE 에서는 그 
모두에 기정값들의 표준모임을 리용하고 창문이 구축된 후에 프로그람이 변경하는데 사용할 
수 있는 함수들을 가지고있기때문이다. 

3. 사건에 응답하기 

KDE 와 Win 32 프로그람은 모두 사건구동형이다. 다시 말하면 두 프로그람이 초기화되고 
창문이 현시되면 KDE 와 Win 32 는 사건(마우스, 건반 또는 기타;)이 일어나기를 기다린다. 사 





















건이 발생할 때 체계에서 응용프로그람에로 정보를 넘기기 위한 함수가 호출된다. 두 프로 
그람은 2개의 특정한 사건 즉 창문크기가 변화할 때 그리고 창문의 전부 또는 일부분이 로 
출되여 다시 그려야 할 때 응답할 필요가 있다. 

21행 에 서 KDE 프로그람은 창문을 그려야 할 때 마다 호출하는 QWidget 의 순수가상메 쏘 
드 paintEventO 를 재 정 의 한다. 이 함수는 resizeEventG 의 최 근호출로부터 얻 어 진 크기 와 위 치 
값들을 리용하여 겹쌓인 4각형들을 그린다. Win 32 프로그람은 68행에서 case 문에 의해 이것을 
달성 한다. 

KDE 프로그람은 44행에서 창문이 처음으로 표시되고 그 크기가 바뀔 때마다 호출되는 
QWidget 의 가상메쏘드 resizeEventO 를 재 정의 한다. 같은 기 능은 Win 32 프로그람의 callback () 함 
수의 62행의 case 문에서 달성 된다. 두 경 우에 새로운 크기 정보는 xBoxl , yBoxl , xBox 2, yBox 2 
변수들에 기억된다. 

알아두기 : 사건을 처 리 하는 이 두 메 쏘드는 류사하다. KDE 응용프로그람은 매 개 사건 에 
대 하여 각이한 역 호출메 쏘드를 지 정한다. Win 32 프로그람에서 1개 역 호출함수는 매 개 사건 에 
대하여 개별적인 case 문을 포함하는 발송자로서 리용될수 있으므로 매개 사건에 대하여 개 
별적인 함수를 호출한다. 

4. 기본순환고리 

KDE 프로그람은 14행의 exec () 를 호출한다. 이 함수는 프로그람이 완료할 시간이 될 때 
까지 되돌아오지 않는다. 그것은 사건을 기다리다가 적당한 메쏘드를 호출하게 하는 일감을 
수행한다. Win 32 프로그람의 기본순환고리는 44〜47행에 있다. 함수 GetMessage () 는 사건을 
수신하기를 기다리며 그다음 되돌아간다. TranslateMessage () 호출은 건반코드를 문자로 변환하 
고 DispatchMessage () 는 정확한 창문에 사건을 보낸다. 

5. 프론그람완료 

Win 32 프로그람을 완료할 때 역호출함수는 WM_DESTROY 통보문과 함께 호출된다. 
PostQuitMessageO 호출은 89행 에서 이 루어 지 고 입 력 대기렬에 완료통보문을 배치 하고 그것을 
읽을 때 프로그람은 끝난다. 이것은 작성자에게 완료하기전에 모든 객체들을 삭제하거 나 또 
는 완료를 거절할 기회를 준다. 

KDE 응용프로그람완료는 KApplication 객체의 초기화과정에 설정되는 환경으로 구축된 
다. 최 상위창문을 닫으면 응용프로그람도 완료한다. 또한 응용프로그람완료는 최 상위창문을 
닫는다. 창문꼭대기의 제목띠는 마우스가 창문을 닫는데 쓰일수 있도록 완료과정과 련결된 
다. 

6. 대역자료 

Win 32 프로그람은 C 로 작성되였기때문에 그것은 역호출함수호출들사이에 남아있는 값 
들을 보관하는데 대역기억기를 사용할것을 요구한다. 물론 Win 32 판은 C ++ 로 작성될수 있고 
대역자료를 밀봉할수 있는 객체가 제안되였으나 그 수법은 API 자체의 부분이 아니다. 이 
실 례 에 서 대 역 자료는 7행 에 서 변 수 xBoxl , yBoxl , xBox 2, yBox 2 에 기 억 된 다. 



C ++ 로 작성된 KDE 는 매개의 개별적인 클라스안에 자료를 보관한다. 이 실례에서 제일 바깥 
쪽 직4각형의 모서리들은 xBoxl , yBoxl ， xBox 2， yBox 2 에 보관되며 머리부파일의 12〜15행에 
서 정의되였다. 


제4절. GNOME 프로그람 

다음 실례는 중심이 갈은 직4각형들로 창문을 가득 채운다. 이전 실례처럼 창문크기가 
변화하면 직4각형들의 크기도 변한다. 창문은 그림 20-3 과 같다. 

1 /** boxboxx ( Gnome ) **/ 

2 #include < gnome . h > 

3 

4 gint eventDelete(GtkWidget * widget , 

5 GdkEvent * event,gpointer data ); 

6 gint e ventDestroy (GtkW idget * widget , 

7 GdkEvent * event,gpointer data ); 

8 gboolean eventExpose(GtkWidget * widget , 

9 GdkEvent * event,gpointer data ); 

10 gint eventConfigure(GtkWidget * widget , 

11 GdkEventConfigure * event,gpointer data ); 

12 

13 #defme STEP 3 

14 

15 static char name [] = “ BoxBox ” ; 

16 static int xBoxl ; 

17 static int yBoxl ; 

18 static int xBox 2; 

19 static int yBox 2; 

20 

21 int main(int argc’char * argv []) 

22 { 

23 GtkWidget * app ; 

24 GtkWidget * area ; 

25 

26 gnome _ init ( name ,” 1.0” , argc , argv ); 

27 app = gnome _ app _ new ( name ,” Boxes in Boxes ” ); 

28 gtk _ signal _ comect ( GTK _ OBJECT ( app ),” delete event ” , 

628 





29 GTK_SIGNAL_FUNC(eventDelete) 5 NULL); 

30 gtk_signal_connect(GTK_OBJECT(app),’’ destroy” , 

31 GTK_SIGNAL_FUNC(eventDestroy),NULL); 

32 

33 area = gtk_drawing_area_new(); 

34 gnome_app_set_contents(GNOME_APP(app),area); 

35 

36 gtk_signal_connect(GTK_OBJECT(area),expose_event” , 

37 GTK_SIGNAL_FUNC(eventExpose),NULL); 

3 8 gtk_signal_connect(GTK_OBJECT(area), ” configure_event’’ , 

39 GTK_SIGNAL_FUNC(eventConfigure),NULL); 

40 

41 gtk_widget_show_all(app); 

42 gtk_main(); 

43 exit(0); 

44} 

45 gboolean eventExpose(GtkWidget *widget, 

46 GdkEvent *event,gpointer data) { 

47 intxl; 

48 intyl; 

49 int x2; 

50 int y2; 

51 

52 xl =xBoxl; 

53 yl =yBoxl; 

54 x2 = xBox2; 

55 y2 = yBox2; 

56 while((xl < x2) && (yl < y2)) { 

57 gdk_draw_line(widget->window, 

5 8 widget->style->black_gc, 

59 xl ， yl ， x2 ， yl) ; 

60 gdk_draw_line(widget->window, 

61 widget->style->black_gc, 

62 x2,yl,x2,y2); 
gdk_draw_line(widget->window, 


63 
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64 widget->style->black_gc, 

65 x2,y2,xl,y2); 

66 gdk_draw_line(widget->window, 

67 widget->style->black_gc, 

68 xl,y2,xl,yl); 

69 xl += STEP; 

70 yl += STEP; 

71 x2 -= STEP; 

72 y2 -= STEP; 

73 } 

74 return (TRUE); 

75} 

76 gint eventConfigure(GtkWidget * widget, 

77 GdkEventConfigure *event,gpointer data) 

78 { 

79 xBoxl = 10; 

80 yBoxl = 10; 

81 xBox2 = event->width - 10; 

82 yBox2 = event->height - 10; 

83 return (TRUE); 

84} 

85 gint eventDelete(GtkWidget *widget, 

86 GdkEvent *event,gpointer data) { 

87 retum(FALSE); 

88 } 

89 gint eventDestroy(GtkWidget *widget, 

90 GdkEvent *event,gpointer data) { 

91 gtk_main_quit(); 

92 return (0); 

93} 
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그림 20-3. GNOME 기 본창문 

이 프로그람은 GNOME 를 초기 화하고 현시할 창문을 만들며 역 호출들을 지 정 한다 . 그 
리고 실행순환고리 에 들어가는 mam() 을 가지고있다 . 4 가지 의 다른 함수가 있는데 그 매개는 
특정한 사건이 일어날 때 실행한다 . 

사건들에 응답하기 위하여 설정된것들을 엄으려면 좀 더 노력하여 야 한다 . 36 행과 38 행 
의 gtk_signal_connect() 호출은 프로그람이 창문크기를 설정하고 그리는 사건들을 받는데 필요 
하다 . 또한 응용프로그람이 사용자에 의해 정지될수 있도록 마우스에 응답하기 위한 역호출 
을 설정하는데도 필요하다 . 이것은 28 행과 30 행에서 gtk_signal_connectO 호출에 의해 수행된 
다 . 


요 약 

Win32 응용프로그람과 KDE 응용프로그람의 기본구성방식은 같다 . 모두 사건에 기초한다 . 
GNOME 응용프로그람도 류사한 특성을 가지고있다 . 

이 장에서는 다음에 같은것을 고찰하였다 . 

• Win32, KDE 그러 고 GNOME 은 모두 사건들의 도착을 기 다리 는 무한순환고리 라는 개 
념을 사용한다 . 

• 그것들은 모두 갈은 량의 코드를 요구하지만 어떤것은 다른것보다 특별한 위치에서 
더 자계한것을 요구할수 있다 . 

•3 개의 응용프로그람은 모두 최상위창문이라는 개 념을 공유하며 모든 최상위창문은 
사건들을 받아들일수 있다 . 

• 그것들은 모두 응용프로그람이 정확히 닫기도록 하는 메쏘드를 제공한다 . 
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부록. 쏘프트웨어개발을 위한 설정 

KDE / Qt 응용프로그람을 작성하기 전에 많은 쏘프트웨어 구성요소들을 설치하여야 한다. 

1. Linux 

우선 Linux CD 를 구입해 야 한다. 상업 용 CD 는 필요한 대부분의 항목을 포함하고있으므 
로 내 리적재판보다 설치 하기 쉽다. 

인 터네 트로 Linux 문서 를 얻 으러 고 한다면 판선 택 에 주의해 야 한다. 주로 사용자들은 시 
험판을 얻으러고 하지 않는다. Linux 판번호는 안정판과 개발판을 구분한다. Linux 핵심자체에 
서 일하고있지 않는 한 안정판을 사용하여야 한다. 판번호뒤의 둘째 수자가 짝수(2.0, 2.2, ...) 
이면 안정판이다. 판번호에서 3번째 수 (2.2.8) 는 오유고착상태를 가리킨다. 최근판의 핵심을 
얻 으러 면 가장 큰 짝수번호판을 구입하여 야 한다. 

2. gcc(egcs) 

이것은 프로그람을 를파일하는데 필요한 C 를파일러이다. 1999년 4월에 앞으로의 계획때 
문에 Free Software Foundation 는 egcs Steering Committeeto 에 gcc 을 유지할것 을 확정 하였 다. 그 
당시 이름은 gcc 에서 egcs 로 바뀌였다. 그러나 모든 현존제작파일들과 작업해야 하므로 여전 
히 실행프로그람은 gcc 라고 부론다. 

Linux 배포물에는 gcc 콤파일러가 반드시 있다. 그러나 새로운 특성들이 때때로 추가되므 
로 현재 리 용되 고있는 KDE 쏘프트웨어 의 판을 가지 고있는가 확인하는것 이 필요하다. 

3. XFree86 

이것은 어에 의해 사용되는 저수준창문작성쏘프트웨어 이 다. 모든 Linux 배포물에는 이 
쏘프트웨어가 있으며 표준설치로 설치할수 있다. 이것은 매우 안정된 쏘프트웨어 이지만 특 
수한 경우에만 사용하는 배포물이다. 

4. autoconf 와 automake 

GNOME 배포물 원천코드를 콤파일한다면 이 편의프로그람들이 필요된다. 이 편의프로 
그람들은 제 작파 일 들을 자동적 으로 만들고 프로그람을 콤파 일하는데 사용된 다. 콤파 일 과정 
에 문제가 제기되면 최종판을 가지고 확인해야 한다. 프로그람을 콤파일할 때 이 편의프로 
그람들을 사용할수 있다. 

5. KDE 와 Qt 

KDE 의 사본을 구입할 때 그에 일치 하는 (겨의 판도 따라온다. KDE 와 어는 항상 갱신되 
므로 호환성을 보증하기 위하여 KDE 와 함께 공급된 (가의 판을 사용하는것이 중요하다. 그 
일부는 오직 안정(출하)판만 제공하고 다른 일부는 불안정한(개발)판을 제공한다. 그러므로 
KDE 의 출하판을 리용하겠는가 아니 면 최 종개발판을 리 용하겠는가 결심 해 야 한다. 그 결심 
은 사용자가 무엇을 하려고 하는가에 달려있다. 



안정판을 선택한다면 mirror 싸이트를 하나 선택하고 README 파일의 지시를 따라 자기 
Linux 판에 적합한 등록부들을 선택해야 한다. KDE 에서 몇가지 다른 묶음선택을 사용할수 
있다 .Red Hat 에는 RPM 파일들， Debian 에는 DEB 파일들이 그리고 일반설치용으로 tar 파일들이 
있다. 


6. 최근판의 구입과 설치 

최신판의 쏘프트웨어를 엄어서 갱신하려고 한다면 마지막으로 내리적재한 후 변경된것들 
만 포함하는 갱신내용을 계속 내리적재하는 방법으로 모든 원천코드를 내리적재한다. 

1) CVS 쏘프트웨어 

CVS (병행판체겨 j ) 는 프로그람의 원천파일들에 대한 변화궤적을 보유하는 원천코드조종 
체계 이 다. KDE 와 Qt 는 모두 CVS 에 의해 관리 된다. 자기 체계 에 CVS 라는 편의 프로그람이 있 
어야 한다. 

쏘프트웨어 를 개 발하려 면 CVS 쏘프트웨어 에 대하여 알아야 한다. CVS 는 원천코드모듈 
을 검사하여 같은 원천코드의 여러판의 개발을 방지하는데 쓰이므로 여러명의 사람들이 쏘 
프트웨어 를 변 경 하려 고 할 때 특별 히 필요하다. 

2) Creating a CVS 환경파일의 만들기 

CVS 를 실행하기 전에 미리 설치되여야 할것이 있다. 자기 홈등록부에서 다음 내용으 
로 .cvsrc 라는 본문파일을 만든다. 
cvs - z 4 -q 
diff - u 3 -p 
update -dP 
checkout -P 

선택설정에 문자 p 를 쓰는데 주의하여야 한다. Diff 행에서 그것은 소문자이고 update 와 
checkout 행 에 서 는 대 문자이 다. 

3) CVSROOT 환경변수의 설정 

원격싸이트에서 원천을 발견할 장소를 CVS 에게 알리는 환경변수를 설정해야 한다. 
다음과 같이 입력한다. 

export CVSROOT -=: pserver : anonymous @ anoncvs . kde . org :/ home/kde 

4) 원격 CVS 봄사기에 가입 

원천나무의 부모등록부로 하려는 등록부를 만든다. 자기가 선택한 KDE 의 각 부분은 보 
조등록부를 만드므로 새로운 등록부로 변경하고 다음 지 령을 입 력한다. 
cvs login 

암호를 요구할수 있는데 Return 또는 Enter 를 누른다. 봉사기의 응답에 시간이 걸 릴수 
있으므로 몇분 기다릴수 있다. 

5) 원천파일사본의 내리적재 

다음의 지령목록은 모든 원천을 내리적재한다. (스크립트로 편집되여 헌번에 실행될수 



있다.) 모두 요구하지 않으면 이 지령들중 일부를 떨수 있다. 
cvs checkout kde - qt-addon 
cvs checkout qt-copy 
cvs checkout kdelibs 
cvs checkout kde - il 8 n 
cvs checkout kdeadmin 
cvs checkout kdebase 
cvs checkout kdegames 
cvs checkout kdegraphics 
cvs checkout kdemultimedia 
cvs checkout kdenetwork 
cvs checkout kdesdk 
cvs checkout kdesupport 
cvs checkout kdetoys 
cvs checkout kdeutils 
cvs checkout kdevelop 
cvs checkout kdoc 
cvs checkout kfle 
cvs checkout klyx 
cvs checkout kmusic 
cvs checkout koffice 
cvs checkout korganizer 
cvs checkout ksite 
cvs checkout kdepim 
6) 변경의 유지 

마지막 내리적재이후 변경된 원천을 내리적재할 때마다 원천코드의 새로운 사본을 구 
입할수 있다. 원래의 내리적재시에 수행한 모든 조작을 한다. 그러나 CVS 지령행에서 검사하 
지 않고 update 를 리용한다. 실례로 qt - copy 등록부의 최신판을 내리적재하려면 다음 지령을 
입 력 한다. 



모든것은 최신판으로 갱신하려면 검사에서 리용한 스크립트를 리용하지만 모든 지령을 
update 로 바꾸어야 한다. 다시 스크립트를 실행할수 있다. 

7) 코드의 콤파일 

원천코드의 매개 등록부는 개별적으로 를파일되여야 한다. 우선 를파일해야 하는 등록 
부는 qt-copy 등록부이다. 그것은 거의 모든 다른 등록부들이 여기에 의존하기때문이다. 





qt-copy 등록부를 변경하고 다음과 같이 4개 지령을 입력한다. 
make -f Makefile.cvs 

./configure -sm -gif - system-libpng - system-jpeg 
make 

make install 

그다음 나머지 매개 등록부에서 다음의 4개 지 령을 입 력한다. 

make -f Makefile.cvs 

./configure 

make 

make install 

각이한 등록부들에 의해 생성된 서고들중에 일부 의존관계가 있다. 일부 등록부는 다른 
등록부들보다 먼저 를파일되여야 한다. 우선 qt-copy 을 콤파일하고 그 다음 kde - qt - addon , 
kdebase 그리고 kdelib 를 콤파일해야 한다. 

모두에 대한 삭제콤파일을 할 때에는 등록부들의 순서를 반전해야 한다. 4개 지령중 처음 2 
개는 한번만 입력해야 한다. 등록부를 재시동해야 한다면 3번째 지령으로 기동한다. 


참고문헌 


Jusmin Blanchette , Mark Summerfield 《 C ++ GUI Programming with Qt 3》 Prentice 
Hall , 2004. 



이 책은 콤퓨터를 전공으로 하는 교원，연구사，대학생들을 위한 참고서이다. 
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